system.delta_lake_metadata_log

system.delta_lake_metadata_log テーブルは、ClickHouse によって読み取られた Delta Lake テーブルのメタデータへのアクセスおよび解析イベントを記録します。各メタデータファイルに関する詳細な情報を提供し、デバッグや監査、Delta テーブル構造の変化を理解する際に有用です。

目的

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

注記

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

列

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 ファイル由来の生のメタデータ）。

ClickHouse Cloud でのクエリ実行

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

ログの詳細度の制御

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}';