> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# system.delta_lake_metadata_log

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

<div id="purpose">
  ## 描述
</div>

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

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

<Note>
  此表主要用于调试。
</Note>

<div id="controlling-log-verbosity">
  ### 控制日志详细级别
</div>

你可以使用 [`delta_lake_log_metadata`](/zh/reference/settings/session-settings#delta_lake_log_metadata) 设置来控制哪些元数据事件会被记入日志。

要记录当前查询中使用的所有元数据：

```sql theme={null}
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}';
```

<div id="columns">
  ## 列
</div>

* `hostname` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 执行该查询的服务器主机名。
* `event_date` ([Date](/zh/reference/data-types/date)) — 记录日期。
* `event_time` ([DateTime](/zh/reference/data-types/datetime)) — 事件时间。
* `query_id` ([String](/zh/reference/data-types/string)) — 查询 ID。
* `table_path` ([String](/zh/reference/data-types/string)) — 表路径。
* `file_path` ([String](/zh/reference/data-types/string)) — 文件路径。
* `content` ([String](/zh/reference/data-types/string)) — JSON 格式的内容。