Referenční informace k systémové tabulce automatických upgradů

Important

Tato systémová tabulka je ve verzi Public Preview.

Tato stránka popisuje schéma tabulky historie operací automatických upgradů a zobrazuje ukázkové dotazy. Automatické upgrady automaticky zapnou funkce osvědčených postupů ve spravovaných tabulkách Katalogu Unity bez nutnosti změn kódu. Systémová tabulka sleduje historii těchto operací. Informace o automatických upgradech najdete v tématu Automatické upgrady.

Cesta k tabulce: Tato systémová tabulka se nachází na system.storage.table_auto_upgrade_operations_historyadrese .

Automatické upgrady schématu tabulek

Systémová tabulka historie automatických upgradů používá následující schéma:

Název sloupce	Datový typ	Description	Example
account_id	řetězec	ID účtu.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	řetězec	Název metastoru, do kterého upgradovaná tabulka patří.	metastore1
metastore_id	řetězec	ID metastoru, do kterého upgradovaná tabulka patří.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	řetězec	Název katalogu, do kterého patří upgradovaná tabulka.	catalog
schema_name	řetězec	Název schématu, do kterého patří upgradovaná tabulka.	schema
table_name	řetězec	Název upgradované tabulky.	table1
table_id	řetězec	ID upgradované tabulky.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	řetězec	Funkce tabulky, která se automatické upgrady pokusily zapnout, například deletionVectors nebo rowTracking.	rowTracking
operation_id	řetězec	Jedinečné ID operace.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	řetězec	Typ operace. Hodnoty zahrnují ENABLE nebo DISABLE.	ENABLE
operation_result	řetězec	Výsledek pokusu o operaci upgradu. Hodnoty zahrnují SUCCESSFUL nebo FAILED: INTERNAL_ERROR. Viz operation_result hodnoty.	SUCCESSFUL
start_time	časové razítko	Čas, kdy byla operace spuštěna. Informace o časovém pásmu se zaznamenávají na konci hodnoty, přičemž +00:00 představuje UTC.	2023-01-09 10:00:00.000+00:00
end_time	časové razítko	Čas ukončení operace. Informace o časovém pásmu se zaznamenávají na konci hodnoty, přičemž +00:00 představuje UTC.	2023-01-09 11:00:00.000+00:00

operation_result hodnoty

Ve operation_result sloupci se zobrazuje, jestli byla operace upgradu úspěšná nebo jestli se nepovedlo zapnout funkci, která je zaznamenána v feature_namepříslušné tabulce. Pokud se nepovedla (zpráva FAILED: INTERNAL_ERROR), můžete funkci povolit ručně.

Příkladové dotazy

Následující části obsahují ukázkové dotazy, které můžete použít k získání přehledu o systémové tabulce automatických upgradů. Hodnoty parametrů musíte nahradit vlastními hodnotami.

Dotazování operací automatického upgradu pro všechny funkce v konkrétní tabulce

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;

Dotaz na počet operací automatického upgradu za posledních 30 dnů

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;

Dotaz na míru úspěšnosti automatických upgradů

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;

Dotaz na operace automatického upgradu, které selhaly

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;