> ## 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>

이 시스템 테이블(system table)에는 ClickHouse에 있는 Iceberg 테이블(table)의 파일별 메타데이터(metadata)가 저장됩니다. 각 테이블의 현재 스냅샷이 참조하는 데이터 파일 또는 삭제 파일마다 1개의 행이 있으며, ClickHouse에 Iceberg 테이블이 없으면 이 테이블은 비어 있습니다.

<div id="columns">
  ## 컬럼
</div>

* `database` ([String](/ko/reference/data-types/string)) — 데이터베이스 이름.
* `table` ([String](/ko/reference/data-types/string)) — 테이블 이름.
* `snapshot_id` ([Int64](/ko/reference/data-types/int-uint)) — 파일이 추가된 스냅샷 ID.
* `content` ([Enum8('DATA' = 0, 'POSITION\_DELETE' = 1, 'EQUALITY\_DELETE' = 2)](/ko/reference/data-types/enum)) — 파일 콘텐츠 유형.
* `file_path` ([String](/ko/reference/data-types/string)) — 파일의 해석된 스토리지 경로.
* `file_format` ([String](/ko/reference/data-types/string)) — 파일 포맷(예: 'PARQUET').
* `record_count` ([Int64](/ko/reference/data-types/int-uint)) — 파일의 레코드 수.
* `file_size_in_bytes` ([Int64](/ko/reference/data-types/int-uint)) — 파일 크기(바이트).
* `partition` ([String](/ko/reference/data-types/string)) — 파티션 튜플의 텍스트 표현.
* `schema_id` ([Int32](/ko/reference/data-types/int-uint)) — 이 매니페스트 항목에 대해 해석된 스키마 ID.
* `sequence_number` ([Int64](/ko/reference/data-types/int-uint)) — 매니페스트 항목의 해석된 시퀀스 번호(포맷 v1에서는 항상 0).
* `sort_order_id` ([Nullable(Int32)](/ko/reference/data-types/nullable)) — 지정된 경우 파일의 정렬 순서 ID.
* `null_value_counts` ([Map(Int32, Int64)](/ko/reference/data-types/map)) — 컬럼별 NULL 값 수(컬럼 ID -> 개수).
* `column_sizes` ([Map(Int32, Int64)](/ko/reference/data-types/map)) — 컬럼별 디스크상 크기(바이트)(컬럼 ID -> 바이트).
* `value_counts` ([Map(Int32, Int64)](/ko/reference/data-types/map)) — 컬럼별 총값 수(컬럼 ID -> 개수).
* `equality_ids` ([Array(Int32)](/ko/reference/data-types/array)) — 동등성 삭제 파일의 동등성 필드 ID(동등성 삭제 파일이 아닌 경우 비어 있음).