Referenz zur Systemtabelle für automatische Upgrades

Important

Diese Systemtabelle befindet sich in der Public Preview.

Diese Seite beschreibt das Schema der Tabelle für automatische Upgrades des Vorgangsverlaufs und zeigt Beispielabfragen an. Automatische Upgrades aktivieren automatisch Bewährte Methodenfeatures für verwaltete Tabellen im Unity-Katalog, ohne Dass Codeänderungen erforderlich sind. Die Systemtabelle verfolgt den Verlauf dieser Vorgänge. Informationen zu automatischen Upgrades finden Sie unter "Automatische Upgrades".

Tabellenpfad: Diese Systemtabelle befindet sich unter system.storage.table_auto_upgrade_operations_history.

Schema für automatische Upgrades-Tabellen

Die Systemtabelle für den Vorgangsverlauf für automatische Upgrades verwendet das folgende Schema:

Spaltenname	Datentyp	Description	Example
account_id	string	ID des Kontos	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	Der Name des Metaspeichers, zu dem die aktualisierte Tabelle gehört.	metastore1
metastore_id	string	Die ID des Metastores, zu dem die aktualisierte Tabelle gehört.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	Der Name des Katalogs, zu dem die aktualisierte Tabelle gehört.	catalog
schema_name	string	Der Name des Schemas, zu dem die aktualisierte Tabelle gehört.	schema
table_name	string	Der Name der aktualisierten Tabelle.	table1
table_id	string	Die ID der aktualisierten Tabelle.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	Das Tabellenfeature, das automatische Upgrades versucht hat, zu aktivieren, z deletionVectors . B. oder rowTracking.	rowTracking
operation_id	string	Die eindeutige ID für den Vorgang.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Der Typ des Vorgangs. Werte enthalten ENABLE oder DISABLE.	ENABLE
operation_result	string	Das Ergebnis eines versuchten Upgradevorgangs. Werte enthalten SUCCESSFUL oder FAILED: INTERNAL_ERROR. Siehe operation_result Werte.	SUCCESSFUL
start_time	timestamp	Zeitpunkt, zu dem der Vorgang gestartet wurde Zeitzoneninformationen werden am Ende des Werts aufgezeichnet, wobei +00:00 die UTC darstellt.	2023-01-09 10:00:00.000+00:00
end_time	timestamp	Zeitpunkt, zu dem der Vorgang beendet wurde Zeitzoneninformationen werden am Ende des Werts aufgezeichnet, wobei +00:00 die UTC darstellt.	2023-01-09 11:00:00.000+00:00

operation_result Werte

In der operation_result Spalte wird angezeigt, ob ein versuchter Upgradevorgang erfolgreich war oder ein Feature, das in feature_nameeiner berechtigten Tabelle aufgezeichnet wurde, aktiviert oder nicht aktiviert werden konnte. Wenn ein Fehler (Meldung FAILED: INTERNAL_ERROR) aufgetreten ist, können Sie das Feature manuell aktivieren.

Beispielabfragen

Die folgenden Abschnitte enthalten Beispielabfragen, mit denen Sie Einblicke in die Systemtabelle für automatische Upgrades erhalten können. Sie müssen die Parameterwerte durch Ihre eigenen Werte ersetzen.

Abfragen von automatischen Upgradevorgängen für alle Features in einer bestimmten Tabelle

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;

Abfragen der Anzahl der automatischen Upgradevorgänge in den letzten 30 Tagen

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;

Abfragen der Erfolgsquote für automatische Upgrades-Vorgänge

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;

Abfrage nach fehlgeschlagenen automatischen Upgradevorgängen

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;