system.delta_lake_metadata_log

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

Purpose

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

注記

このテーブルは主にデバッグ目的で使用されます。

注記

Columns

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 関数が必要です。詳細については こちら を参照してください。

Controlling log verbosity

現在のクエリで使用されるメタデータイベントのログを制御するには、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}';