Informations de référence sur les mises à niveau automatiques de la table système

Important

Cette table système est en préversion publique.

Cette page décrit le schéma de la table d’historique des opérations de mise à niveau automatique et affiche des exemples de requêtes. Les mises à niveau automatiques activent automatiquement les fonctionnalités recommandées sur vos tables managées du catalogue Unity sans nécessiter de modifications de code. La table système suit l’historique de ces opérations. Pour plus d’informations sur les mises à niveau automatiques, consultez Mises à niveau automatiques.

Chemin d’accès de la table : cette table système se trouve à l’emplacement system.storage.table_auto_upgrade_operations_history.

Schéma de table des mises à niveau automatiques

La table système de l’historique des opérations de mise à niveau automatique utilise le schéma suivant :

Nom de la colonne	Type de données	Description	Example
account_id	string	Identificateur du compte.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	Nom du metastore auquel appartient la table mise à niveau.	metastore1
metastore_id	string	ID du metastore auquel appartient la table mise à niveau.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	Nom du catalogue auquel appartient la table mise à niveau.	catalog
schema_name	string	Nom du schéma auquel appartient la table mise à niveau.	schema
table_name	string	Nom de la table mise à niveau.	table1
table_id	string	ID de la table mise à niveau.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	Fonctionnalité de table sur laquelle les mises à niveau automatiques ont tenté d’activer, par deletionVectors exemple ou rowTracking.	rowTracking
operation_id	string	ID unique de l’opération.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Type d’opération. Les valeurs incluent ENABLE ou DISABLE.	ENABLE
operation_result	string	Résultat d’une tentative d’opération de mise à niveau. Les valeurs incluent SUCCESSFUL ou FAILED: INTERNAL_ERROR. Consultez operation_result valeurs.	SUCCESSFUL
start_time	timestamp	L’heure à laquelle l’opération a démarré. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente le fuseau horaire UTC.	2023-01-09 10:00:00.000+00:00
end_time	timestamp	L’heure à laquelle l’opération s’est terminée. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, où +00:00 représente le fuseau horaire UTC.	2023-01-09 11:00:00.000+00:00

valeurs de operation_result

La operation_result colonne indique si une tentative d’opération de mise à niveau a réussi ou n’a pas pu 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 insights sur la table système des mises à niveau automatiques. Vous devez remplacer les valeurs de paramètre par vos propres valeurs.

Interroger les opérations de mise à niveau automatique pour toutes les fonctionnalités d’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;

Interroger le nombre d’opérations de mise à niveau automatique 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 mise à 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;

Requête 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;