system.delta_lake_metadata_log

system.delta_lake_metadata_log 表会记录 ClickHouse 在读取 Delta Lake 表时的元数据访问和解析事件。它为每个元数据文件提供详细信息，对于调试、审计以及了解 Delta 表结构的演变非常有用。

目的

此表记录从 Delta Lake 表中读取的所有元数据文件。它帮助用户跟踪 ClickHouse 如何解释 Delta 表元数据，并诊断与模式演进、快照解析或查询规划相关的问题。

注意

此表主要用于调试。

列

名称	类型	描述
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}';