> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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/index)) — 데이터베이스 이름.
* `table` ([String](/ko/reference/data-types/index)) — 테이블 이름.
* `snapshot_id` ([Int64](/ko/reference/data-types/index)) — 파일이 추가된 시점의 스냅샷 ID입니다.
* `content` ([Enum8('DATA' = 0, 'POSITION\_DELETE' = 1, 'EQUALITY\_DELETE' = 2)](/ko/reference/data-types/index)) — 파일 콘텐츠 유형입니다.
* `file_path` ([String](/ko/reference/data-types/index)) — 파일의 실제 스토리지 경로입니다.
* `file_format` ([String](/ko/reference/data-types/index)) — 파일 포맷입니다. 예: 'PARQUET'.
* `record_count` ([Int64](/ko/reference/data-types/index)) — 파일의 레코드 수입니다.
* `file_size_in_bytes` ([Int64](/ko/reference/data-types/index)) — 파일 크기(바이트)입니다.
* `partition` ([String](/ko/reference/data-types/index)) — 파티션 튜플의 텍스트 표현입니다.
* `schema_id` ([Int32](/ko/reference/data-types/index)) — 이 매니페스트 항목에 대해 확인된 schema ID입니다.
* `sequence_number` ([Int64](/ko/reference/data-types/index)) — 매니페스트 항목에 대해 확인된 시퀀스 번호입니다(포맷 v1에서는 항상 0).
* `sort_order_id` ([Nullable(Int32)](/ko/reference/data-types/index)) — 지정된 경우 파일의 정렬 순서 ID입니다.
* `null_value_counts` ([Map(Int32, Int64)](/ko/reference/data-types/index)) — 컬럼별 null 값 개수입니다(컬럼 id -> 개수).
* `column_sizes` ([Map(Int32, Int64)](/ko/reference/data-types/index)) — 컬럼별 디스크 크기(바이트)입니다(컬럼 id -> 바이트).
* `value_counts` ([Map(Int32, Int64)](/ko/reference/data-types/index)) — 컬럼별 전체 값 개수입니다(컬럼 id -> 개수).
* `equality_ids` ([Array(Int32)](/ko/reference/data-types/index)) — equality delete 파일의 equality 필드 ID입니다(비-equality-delete 파일에서는 비어 있음).