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

> 包含 Iceberg 表各文件元数据的系统表

# system.iceberg_files

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

该系统表包含 ClickHouse 中现有 Iceberg 表的按文件划分的元数据；每个表当前快照引用的每个数据文件或删除文件各对应一行。如果 ClickHouse 中没有任何 Iceberg 表，该表将为空。

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

* `database` ([String](/zh/reference/data-types/string)) — 数据库名称。
* `table` ([String](/zh/reference/data-types/string)) — 表名称。
* `snapshot_id` ([Int64](/zh/reference/data-types/int-uint)) — 添加该文件时的快照 ID。
* `content` ([Enum8('DATA' = 0, 'POSITION\_DELETE' = 1, 'EQUALITY\_DELETE' = 2)](/zh/reference/data-types/enum)) — 文件内容类型。
* `file_path` ([String](/zh/reference/data-types/string)) — 文件解析后的存储路径。
* `file_format` ([String](/zh/reference/data-types/string)) — 文件格式，例如 'PARQUET'。
* `record_count` ([Int64](/zh/reference/data-types/int-uint)) — 文件中的记录数。
* `file_size_in_bytes` ([Int64](/zh/reference/data-types/int-uint)) — 文件大小 (以字节为单位) 。
* `partition` ([String](/zh/reference/data-types/string)) — 分区 Tuple 的文本表示。
* `schema_id` ([Int32](/zh/reference/data-types/int-uint)) — 为此清单条目解析的 schema ID。
* `sequence_number` ([Int64](/zh/reference/data-types/int-uint)) — 清单条目的解析序列号 (格式 v1 始终为 0) 。
* `sort_order_id` ([Nullable(Int32)](/zh/reference/data-types/nullable)) — 文件的排序顺序 ID (如已指定) 。
* `null_value_counts` ([Map(Int32, Int64)](/zh/reference/data-types/map)) — 每列的 NULL 值数量 (列 ID -> 数量) 。
* `column_sizes` ([Map(Int32, Int64)](/zh/reference/data-types/map)) — 每列的磁盘占用大小 (以字节为单位；列 ID -> 字节数) 。
* `value_counts` ([Map(Int32, Int64)](/zh/reference/data-types/map)) — 每列的值总数 (列 ID -> 数量) 。
* `equality_ids` ([Array(Int32)](/zh/reference/data-types/array)) — 等值删除文件的等值字段 ID (非等值删除文件为空) 。