system.delta_lake_metadata_log

ClickHouse Cloud でのクエリ実行

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。

説明

system.delta_lake_metadata_log テーブルは、ClickHouse が読み取る Delta Lake テーブルのメタデータへのアクセスおよび解析イベントを記録します。各メタデータファイルに関する詳細情報を提供するため、デバッグ、監査、また Delta テーブル構造の変化を把握する際に役立ちます。

このテーブルは、Delta Lake テーブルから読み取られたすべてのメタデータファイルを記録します。これにより、ClickHouse が Delta テーブルのメタデータをどのように解釈しているかを追跡でき、スキーマの進化、スナップショットの解決、クエリプランニングに関連する問題の診断に役立ちます。

注記

このテーブルは主にデバッグ用途を想定しています。

ログの詳細度の制御

delta_lake_log_metadata 設定を使用して、どのメタデータイベントをログに記録するかを制御できます。

現在のクエリで使用されるすべてのメタデータをログに記録するには：

SELECT * FROM my_delta_table SETTINGS delta_lake_log_metadata = 1;

SYSTEM FLUSH LOGS delta_lake_metadata_log;

SELECT *
FROM system.delta_lake_metadata_log
WHERE query_id = '{previous_query_id}';

列

Name	Type	Description
event_date	Date	ログファイルの日付。
event_time	DateTime	イベントのタイムスタンプ。
query_id	String	メタデータ読み取りを開始したクエリ ID。
table_path	String	Delta Lake テーブルへのパス。
file_path	String	ルートメタデータ JSON ファイルへのパス。
content	String	JSON 形式の内容 (.json ファイル由来の生のメタデータ) 。