跳转到主内容
跳转到主内容

system.delta_lake_metadata_log

在 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 格式的内容。