Référence des tables système de mises à niveau automatiques
Aperçu
Cette table système est en aperçu public.
Cette page décrit le schéma de la table d'historique des opérations de mises à niveau automatiques et présente des exemples de query. Les mises à niveau automatiques activent automatiquement les fonctionnalités de bonnes pratiques sur vos tables gérées par Unity Catalog sans nécessiter de modifications de code. La table système suit l'historique de ces opérations. Pour plus d'information sur les mises à niveau automatiques, consultez Mises à niveau automatiques.
**Chemin de la table** : Cette table système est située system.storage.table_auto_upgrade_operations_history à.
Schéma de la table des mises à niveau automatiques
La table système de l'historique des opérations de mises à niveau automatiques utilise le schéma suivant :
Nom de colonne | Type de données | Description | Exemple |
|---|---|---|---|
| chaîne | L'ID du compte. |
|
| chaîne | Le nom du métastore auquel la table mise à niveau appartient. |
|
| chaîne | L'ID du métastore auquel appartient la table mise à niveau. |
|
| chaîne | Le nom du catalogue auquel appartient la table mise à niveau. |
|
| chaîne | Le nom du schéma auquel appartient la table mise à niveau. |
|
| chaîne | Le nom de la table mise à niveau. |
|
| chaîne | L'ID de la table mise à niveau. |
|
| chaîne | La fonctionnalité de table que les mises à niveau automatiques ont tenté d'activer, telles que |
|
| chaîne | L'identifiant unique de l'Opération. |
|
| chaîne | Le type d'Opération. Les valeurs incluent |
|
| chaîne | Le résultat d'une Opération de mise à niveau tentée. Les valeurs incluent |
|
| Horodatage | L'heure à laquelle l'Opération a start. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où |
|
| Horodatage | L'heure à laquelle l'opération s'est terminée. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où |
|
valeurs operation_result
La colonne operation_result indique si une opération de mise à niveau tentée a réussi ou échoué à activer une fonctionnalité, enregistrée dans feature_name, sur une table éligible. En cas d'échec (message FAILED: INTERNAL_ERROR), vous pouvez activer la fonctionnalité manuellement.
Exemples de requêtes
Les sections suivantes incluent des exemples de requêtes que vous pouvez utiliser pour obtenir des informations sur la table système des mises à niveau automatiques. Vous devez remplacer les valeurs du parameter par vos propres valeurs.
Opérations de mise à niveau automatique de la query pour toutes les fonctionnalités sur une table spécifique
SELECT
feature_name,
operation_result,
start_time,
end_time
FROM system.storage.table_auto_upgrade_operations_history
WHERE
catalog_name = :catalog_name
AND schema_name = :schema_name
AND table_name = :table_name
ORDER BY start_time DESC;
Query le nombre d'Opérations de mise à niveau automatiques au cours des 30 derniers jours
SELECT
feature_name,
operation_result,
COUNT(DISTINCT operation_id) AS operations
FROM system.storage.table_auto_upgrade_operations_history
WHERE timestampdiff(day, start_time, NOW()) < 30
GROUP BY ALL
ORDER BY operations DESC;
Interroger le taux de réussite des opérations de mises à niveau automatiques
WITH operation_counts AS (
SELECT
COUNT(DISTINCT (CASE WHEN operation_result = "SUCCESSFUL" THEN operation_id END)) AS successes,
COUNT(DISTINCT operation_id) AS total_operations
FROM system.storage.table_auto_upgrade_operations_history
)
SELECT successes / total_operations AS success_rate
FROM operation_counts;
Query pour les opérations de mise à niveau automatique qui ont échoué.
SELECT
catalog_name,
schema_name,
table_name,
feature_name,
start_time
FROM system.storage.table_auto_upgrade_operations_history
WHERE operation_result != "SUCCESSFUL"
ORDER BY start_time DESC;