自動アップグレードシステムテーブルのリファレンス

備考

プレビュー

このシステムテーブルは パブリック プレビュー段階です。

このページでは、自動アップグレード操作履歴テーブルのスキーマについて説明し、サンプルクエリを示します。自動アップグレードは、コード変更を必要とせずに、Unity Catalog マネージドテーブルでベストプラクティス機能を自動的に有効にします。システムテーブルは、これらの操作の履歴を追跡します。自動アップグレードに関する情報については、自動アップグレードをご覧ください。

テーブルパス : このシステムテーブルはsystem.storage.table_auto_upgrade_operations_historyにあります。

自動アップグレードのテーブルスキーマ

自動アップグレード操作履歴システムテーブルは次のスキーマを使用します。

列名	データ型	説明	例
account_id	string	アカウントのID。	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	アップグレードされたテーブルが属するメタストアの名前。	metastore1
metastore_id	string	アップグレードされたテーブルが属するメタストアのID。	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	アップグレードされたテーブルが属するカタログの名前です。	catalog
schema_name	string	アップグレードされたテーブルが属するスキーマの名前。	schema
table_name	string	アップグレードされたテーブルの名前。	table1
table_id	string	アップグレードされたテーブルのID。	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	自動アップグレードが有効にしようと試みたテーブル機能: deletionVectors や rowTracking。	rowTracking
operation_id	string	オペレーションの一意のID。	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	操作の種類。値にはENABLEまたはDISABLEが含まれます。	ENABLE
operation_result	string	アップグレード操作の試行結果。値には SUCCESSFUL または FAILED: INTERNAL_ERROR が含まれます。operation_result の値を参照してください。	SUCCESSFUL
start_time	timestamp	オペレーションが開始された時刻。 タイムゾーン情報は値の末尾に記録され、 +00:00はUTCを表します。	2023-01-09 10:00:00.000+00:00
end_time	timestamp	オペレーションが終了した時刻。 タイムゾーン情報は値の末尾に記録され、 +00:00はUTCを表します。	2023-01-09 11:00:00.000+00:00

operation_result 値

operation_result列は、対象テーブルでfeature_nameに記録されている、機能の有効化を試みたアップグレード操作が成功したか失敗したかを示しています。失敗した場合 (メッセージ: FAILED: INTERNAL_ERROR)、機能を手動で有効にできます。

クエリの例

次のセクションには、自動アップグレードシステムテーブルに知見を得るために使用できるサンプルクエリーが含まれています。パラメーターの値を独自のデータに置き換える必要があります。

特定のテーブルにおけるすべての特徴量の自動アップグレード操作をクエリする

SQL

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日間の自動アップグレード操作の数を照会します。

SQL

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;

自動アップグレード操作の成功率を照会する

SQL

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;

失敗した自動アップグレード操作に対するクエリ

SQL

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;