system.iceberg_files

Iceberg 테이블의 파일별 메타데이터를 담고 있는 시스템 테이블

설명

이 시스템 테이블(system table)에는 ClickHouse에 있는 Iceberg 테이블(table)의 파일별 메타데이터(metadata)가 저장됩니다. 각 테이블의 현재 스냅샷이 참조하는 데이터 파일 또는 삭제 파일마다 1개의 행이 있으며, 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) — 파티션 튜플의 텍스트 표현입니다.
• 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)) — equality delete 파일의 equality 필드 ID입니다(비-equality-delete 파일에서는 비어 있음).