system.iceberg_files

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

描述

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

列

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