Automatikus frissítési rendszertábla-referencia

Important

Ez a rendszertábla nyilvános előzetes verzióban érhető el.

Ez a lap az automatikus frissítési műveletelőzmények táblázatsémáját ismerteti, és minta lekérdezéseket jelenít meg. Az automatikus frissítések automatikusan bekapcsolják a unitykatalógus által felügyelt táblák ajánlott eljárásait anélkül, hogy kódmódosításra lenne szükség. A rendszertábla nyomon követi ezeknek a műveleteknek az előzményeit. Az automatikus frissítésekről további információt az Automatikus frissítések című témakörben talál.

tábla elérési útja: Ez a rendszertábla a system.storage.table_auto_upgrade_operations_historytalálható.

Táblaséma automatikus frissítése

Az automatikus frissítési műveletelőzmények rendszertáblája a következő sémát használja:

Oszlop neve Adattípus Description Example
account_id karakterlánc A fiók azonosítója. 11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name karakterlánc Annak a metaadattárnak a neve, amelyhez a frissített tábla tartozik. metastore1
metastore_id karakterlánc Annak a metaadattárnak az azonosítója, amelyhez a frissített tábla tartozik. 5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name karakterlánc Annak a katalógusnak a neve, amelyhez a frissített tábla tartozik. catalog
schema_name karakterlánc Annak a sémának a neve, amelyhez a frissített tábla tartozik. schema
table_name karakterlánc A frissített tábla neve. table1
table_id karakterlánc A frissített tábla azonosítója. 138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name karakterlánc A tábla funkció, amelyet az automatikus frissítések megpróbáltak bekapcsolni, például deletionVectors vagy rowTracking. rowTracking
operation_id karakterlánc A művelet egyedi azonosítója. 4dad1136-6a8f-418f-8234-6855cfaff18f
operation karakterlánc A művelet típusa. Az értékek közé tartozik ENABLE vagy DISABLE. ENABLE
operation_result karakterlánc A frissítési kísérlet eredménye. Az értékek közé tartozik SUCCESSFUL vagy FAILED: INTERNAL_ERROR. Lásd operation_result értékeket. SUCCESSFUL
start_time timestamp A művelet indításának időpontja. Az időzónára vonatkozó adatokat az érték végén rögzíti a rendszer, az +00:00 az UTC-t jelöli. 2023-01-09 10:00:00.000+00:00
end_time timestamp A művelet befejezésének időpontja. Az időzónára vonatkozó adatokat az érték végén rögzíti a rendszer, az +00:00 az UTC-t jelöli. 2023-01-09 11:00:00.000+00:00

operation_result értékek

Az operation_result oszlop azt mutatja, hogy egy frissítési kísérlet sikeres volt-e, vagy nem sikerült bekapcsolni egy, a jogosult táblában feature_namerögzített funkciót. Ha nem sikerült (üzenet FAILED: INTERNAL_ERROR), manuálisan engedélyezheti a funkciót.

Példakérdések

A következő szakaszok minta lekérdezéseket tartalmaznak, a segítségével betekintést nyerhet az automatikus frissítési rendszertáblába. A paraméterértékeket a saját értékeire kell cserélnie.

Automatikus frissítési műveletek lekérdezése egy adott tábla összes funkciójára vonatkozóan

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;

Az elmúlt 30 nap automatikus frissítési műveleteinek számának lekérdezése

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;

Az automatikus frissítési műveletek sikerességi arányának lekérdezése

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;

Sikertelen automatikus frissítési műveletek lekérdezése

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;