> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.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>

## 描述

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

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

此表主要用于调试。

### 控制日志详细级别

你可以使用 [`delta_lake_log_metadata`](/zh/reference/settings/session-settings/delta-lake#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}';
```

可以随时安全地对该表执行 truncate 或 drop 操作。

## 列

* `hostname` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 执行该查询的服务器主机名。
* `clickhouse_version` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 生成该行的 ClickHouse 服务器版本。
* `system_processor` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 生成该行的 ClickHouse 服务器的 CPU 架构。
* `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 格式的内容。