system.delta_lake_metadata_log

包含从 Delta Lake 表中读取的元数据文件信息的系统表。每个条目 表示一个根元数据 JSON 文件。

在 ClickHouse Cloud 中查询

此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 clusterAllReplicas 函数。更多详情请参见此处。

​

描述

system.delta_lake_metadata_log 表记录 ClickHouse 读取 Delta Lake 表时的元数据访问与解析事件。它提供每个元数据文件的详细信息，有助于调试、审计，以及了解 Delta 表结构的演进过程。

此表会记录从 Delta Lake 表读取的每个元数据文件，帮助用户追踪 ClickHouse 如何解析 Delta 表元数据，并诊断与 schema 演进、快照解析或查询计划相关的问题。

此表主要用于调试。

​

控制日志详细级别

你可以使用 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}';

​

列

• hostname (LowCardinality(String)) — 执行该查询的服务器主机名。
• event_date (Date) — 记录日期。
• event_time (DateTime) — 事件时间。
• query_id (String) — 查询 ID。
• table_path (String) — 表路径。
• file_path (String) — 文件路径。
• content (String) — JSON 格式的内容。