system.iceberg_files

Icebergテーブルの各ファイルに関するメタデータを含むシステムテーブル

説明

このシステムテーブルには、ClickHouse に存在する Icebergテーブルについて、ファイルごとのメタデータが格納されています。各テーブルの現在のスナップショットで参照されているデータファイルまたは削除ファイルごとに、1行が対応します。ClickHouse に Icebergテーブルが1つも存在しない場合、このテーブルは空になります。

カラム

• 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) — このマニフェストエントリに対して解決されたスキーマ ID。
• sequence_number (Int64) — マニフェストエントリの解決済みシーケンス番号 (フォーマット v1 では常に 0) 。
• sort_order_id (Nullable(Int32)) — 指定されている場合のファイルのソート順 ID。
• null_value_counts (Map(Int32, Int64)) — カラムごとの NULL 値の数 (カラム id -> count) 。
• column_sizes (Map(Int32, Int64)) — カラムごとのディスク上のサイズ (バイト単位) (カラム id -> bytes) 。
• value_counts (Map(Int32, Int64)) — カラムごとの値の総数 (カラム id -> count) 。
• equality_ids (Array(Int32)) — equality delete ファイルの equality フィールド ID (equality-delete 以外のファイルでは空) 。