自動升級系統表參考

Important

此系統資料表處於公開預覽狀態。

本頁說明自動升級操作歷史表架構，並展示範例查詢。 自動升級會自動開啟 Unity 目錄管理資料表的最佳實務功能，無需修改程式碼。 系統表追蹤這些操作的歷史。 關於自動升級的資訊，請參見 自動升級。

資料表路徑：此系統資料表位於 system.storage.table_auto_upgrade_operations_history。

自動升級表架構

自動升級操作歷史系統表使用以下結構：

欄位名稱 資料類型 Description Example
account_id 字串 帳戶的標識碼。 11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name 字串 升級後資料表所屬的元儲存庫名稱。 metastore1
metastore_id 字串 升級後的資料表所屬的元儲存庫的 ID。 5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name 字串 升級後表格所屬的目錄名稱。 catalog
schema_name 字串 升級後資料表所屬的結構名稱。 schema
table_name 字串 升級後的桌子名稱。 table1
table_id 字串 升級後桌子的 ID。 138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name 字串 自動升級嘗試開啟的表格功能，例如 deletionVectors 或 rowTracking。 rowTracking
operation_id 字串 這次行動的唯一ID。 4dad1136-6a8f-418f-8234-6855cfaff18f
operation 字串 作業的類型。 值包括 ENABLE 或 DISABLE。 ENABLE
operation_result 字串 這是一次升級作業嘗試的結果。 值包括 SUCCESSFUL 或 FAILED: INTERNAL_ERROR。 請參見 operation_result數值。 SUCCESSFUL
start_time 時間戳記 作業開始的時間。 時區資訊記錄在數值的末尾，其中 +00:00 代表 UTC。 2023-01-09 10:00:00.000+00:00
end_time 時間戳記 作業結束的時間。 時區資訊記錄在數值的末尾，其中 +00:00 代表 UTC。 2023-01-09 11:00:00.000+00:00

operation_result價值觀

欄位顯示 operation_result 嘗試升級操作是否成功啟用了在 中記錄 feature_name的功能，該功能已記錄於 ，該功能在符合資格的表格中。 如果失敗（訊息 FAILED: INTERNAL_ERROR），你可以手動啟用該功能。

範例查詢

以下章節包含範例查詢，供您深入了解自動升級系統表。 你必須用自己的參數值替換參數值。

查詢特定表格上所有功能的自動升級操作

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;

查詢過去 30 天內自動升級操作的次數

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;

查詢自動升級操作的成功率

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;

查詢失敗的自動升級操作

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;
  • Last updated on