> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> MergeTree 테이블의 파트와 컬럼 정보를 담고 있는 시스템 테이블입니다.

# system.parts_columns

<div id="description">
  ## 설명
</div>

[MergeTree](/ko/reference/engines/table-engines/mergetree-family/mergetree) 테이블의 파트와 컬럼 정보를 포함합니다.
각 행은 하나의 데이터 파트를 나타냅니다.

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

* `partition` ([String](/ko/reference/data-types)) — 파티션의 이름입니다.
* `name` ([String](/ko/reference/data-types)) — 데이터 파트의 이름.
* `uuid` ([UUID](/ko/reference/data-types)) — 파트의 UUID입니다.
* `part_type` ([String](/ko/reference/data-types)) — 데이터 파트 저장 포맷입니다. 가능한 값: Wide — 각 컬럼은 파일 시스템의 개별 파일에 저장됩니다. Compact — 모든 컬럼은 파일 시스템의 단일 파일에 저장됩니다.
* `active` ([UInt8](/ko/reference/data-types)) — 데이터 파트가 활성 상태인지 나타내는 플래그입니다. 데이터 파트가 활성 상태이면 테이블에서 사용되고, 그렇지 않으면 삭제됩니다. 비활성 데이터 파트는 병합 후에도 남습니다.
* `marks` ([UInt64](/ko/reference/data-types)) — 마크의 개수입니다. 데이터 파트의 대략적인 행 수를 구하려면 마크 개수에 인덱스 세분화 수준(보통 8192)을 곱하십시오(이 방법은 adaptive granularity에는 적용되지 않습니다).
* `rows` ([UInt64](/ko/reference/data-types)) — 행의 개수입니다.
* `bytes_on_disk` ([UInt64](/ko/reference/data-types)) — 모든 data part 파일의 총 크기(바이트)입니다.
* `data_compressed_bytes` ([UInt64](/ko/reference/data-types)) — 데이터 파트(data part)에서 압축된 데이터의 총크기입니다. 모든 보조 파일(예: 마크 파일)은 포함되지 않습니다.
* `data_uncompressed_bytes` ([UInt64](/ko/reference/data-types)) — 데이터 파트(data part) 내 압축되지 않은 데이터의 총 크기입니다. 모든 보조 파일(예: 마크 파일)은 포함되지 않습니다.
* `marks_bytes` ([UInt64](/ko/reference/data-types)) — 마크 파일의 크기입니다.
* `modification_time` ([DateTime](/ko/reference/data-types)) — 데이터 파트(data part)가 있는 디렉터리의 수정 시각입니다. 일반적으로 데이터 파트가 생성된 시각에 해당합니다.
* `remove_time` ([DateTime](/ko/reference/data-types)) — 데이터 파트가 비활성화된 시각입니다.
* `refcount` ([UInt32](/ko/reference/data-types)) — 데이터 파트가 사용되는 위치의 개수입니다. 값이 2보다 크면 해당 데이터 파트가 쿼리 또는 머지에서 사용되고 있음을 의미합니다.
* `min_date` ([Date](/ko/reference/data-types)) — 파티션 키에 Date 컬럼이 포함된 경우의 최소값입니다.
* `max_date` ([Date](/ko/reference/data-types)) — 파티션 키에 Date 컬럼이 포함된 경우 해당 컬럼의 최대값입니다.
* `min_time` ([DateTime](/ko/reference/data-types)) — DateTime 컬럼이 파티션 키에 포함된 경우 해당 컬럼의 최솟값입니다.
* `max_time` ([DateTime](/ko/reference/data-types)) — 파티션 키에 DateTime 컬럼이 포함된 경우 해당 컬럼의 최댓값입니다.
* `partition_id` ([String](/ko/reference/data-types)) — 파티션 ID입니다.
* `min_block_number` ([Int64](/ko/reference/data-types)) — 병합 후 현재 파트를 구성하는 데이터 파트들 중 가장 작은 번호입니다.
* `max_block_number` ([Int64](/ko/reference/data-types)) — 병합 후 현재 파트를 구성하는 데이터 파트 중 가장 큰 번호입니다.
* `level` ([UInt32](/ko/reference/data-types)) — 머지 트리의 깊이입니다. 0은 현재 파트가 다른 파트를 머지해 생성된 것이 아니라 삽입으로 생성되었음을 의미합니다.
* `data_version` ([UInt64](/ko/reference/data-types)) — 데이터 파트에 적용해야 할 뮤테이션을 결정하는 데 사용되는 숫자입니다 (`data_version`보다 버전이 높은 뮤테이션).
* `primary_key_bytes_in_memory` ([UInt64](/ko/reference/data-types)) — 기본 키 값이 사용하는 메모리 양(바이트)입니다.
* `primary_key_bytes_in_memory_allocated` ([UInt64](/ko/reference/data-types)) — 기본 키 값에 예약된 메모리 크기(바이트)입니다.
* `database` ([String](/ko/reference/data-types)) — 데이터베이스 이름입니다.
* `table` ([String](/ko/reference/data-types)) — 테이블 이름입니다.
* `engine` ([String](/ko/reference/data-types)) — 매개변수를 제외한 테이블 엔진 이름입니다.
* `disk_name` ([String](/ko/reference/data-types)) — 데이터 파트를 저장하는 디스크의 이름입니다.
* `path` ([String](/ko/reference/data-types)) — 데이터 파트 파일이 있는 폴더의 절대 경로입니다.
* `column` ([String](/ko/reference/data-types)) — 컬럼 이름입니다.
* `type` ([String](/ko/reference/data-types)) — 컬럼 타입.
* `column_position` ([UInt64](/ko/reference/data-types)) — 테이블에서 컬럼의 순서 위치로, 1부터 시작합니다.
* `default_kind` ([String](/ko/reference/data-types)) — 기본값의 표현식 유형(DEFAULT, MATERIALIZED, ALIAS)이며, 정의되지 않은 경우 빈 문자열입니다.
* `default_expression` ([String](/ko/reference/data-types)) — 기본값에 대한 표현식이며, 정의되지 않은 경우 빈 문자열입니다.
* `column_bytes_on_disk` ([UInt64](/ko/reference/data-types)) — 컬럼의 전체 크기(바이트)입니다.
* `column_data_compressed_bytes` ([UInt64](/ko/reference/data-types)) — 컬럼에 있는 압축 데이터의 총 크기(바이트)입니다.
* `column_data_uncompressed_bytes` ([UInt64](/ko/reference/data-types)) — 컬럼에 있는 압축 해제된 데이터의 총 크기이며, 바이트 단위입니다.
* `column_marks_bytes` ([UInt64](/ko/reference/data-types)) — 컬럼 마크의 크기(바이트)입니다.
* `column_modification_time` ([Nullable(DateTime)](/ko/reference/data-types)) — 컬럼이 마지막으로 수정된 시간입니다.
* `column_ttl_min` ([Nullable(DateTime)](/ko/reference/data-types)) — 컬럼에 대해 계산된 TTL 표현식의 최솟값입니다.
* `column_ttl_max` ([널 허용(DateTime)](/ko/reference/data-types)) — 컬럼에서 계산된 TTL 표현식의 최댓값입니다.
* `statistics` ([Array(String)](/ko/reference/data-types)) — 컬럼 통계입니다.
* `estimates.min` ([Nullable(String)](/ko/reference/data-types)) — 컬럼의 추정 최소값입니다.
* `estimates.max` ([Nullable(String)](/ko/reference/data-types)) — 컬럼의 예상 최댓값입니다.
* `estimates.cardinality` ([Nullable(UInt64)](/ko/reference/data-types)) — 컬럼의 추정 카디널리티.
* `estimates.null_count` ([Nullable(UInt64)](/ko/reference/data-types)) — 컬럼의 NULL 값 예상 개수입니다.
* `serialization_kind` ([String](/ko/reference/data-types)) — 컬럼의 직렬화 방식
* `substreams` ([Array(String)](/ko/reference/data-types)) — 컬럼이 직렬화될 하위 스트림 이름
* `filenames` ([Array(String)](/ko/reference/data-types)) — 각 컬럼의 각 하위 스트림에 해당하는 파일 이름
* `subcolumns.names` ([Array(String)](/ko/reference/data-types)) — 컬럼에 속한 서브컬럼의 이름
* `subcolumns.types` ([Array(String)](/ko/reference/data-types)) — 컬럼 서브컬럼의 타입
* `subcolumns.serializations` ([Array(String)](/ko/reference/data-types)) — 컬럼 서브컬럼의 직렬화 종류
* `subcolumns.bytes_on_disk` ([Array(UInt64)](/ko/reference/data-types)) — 각 서브컬럼의 크기(바이트)
* `subcolumns.data_compressed_bytes` ([Array(UInt64)](/ko/reference/data-types)) — 각 서브컬럼의 압축 데이터 크기(바이트 단위)
* `subcolumns.data_uncompressed_bytes` ([배열(UInt64)](/ko/reference/data-types)) — 각 서브컬럼의 압축 해제된 데이터 크기(바이트)
* `subcolumns.marks_bytes` ([Array(UInt64)](/ko/reference/data-types)) — 컬럼의 각 서브컬럼에 대한 마크 크기(바이트)

<div id="example">
  ## 예시
</div>

```sql theme={null}
SELECT * FROM system.parts_columns LIMIT 1 FORMAT Vertical;
```

```text theme={null}
Row 1:
──────
partition:                             tuple()
name:                                  all_1_2_1
part_type:                             Wide
active:                                1
marks:                                 2
rows:                                  2
bytes_on_disk:                         155
data_compressed_bytes:                 56
data_uncompressed_bytes:               4
marks_bytes:                           96
modification_time:                     2020-09-23 10:13:36
remove_time:                           2106-02-07 06:28:15
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
partition_id:                          all
min_block_number:                      1
max_block_number:                      2
level:                                 1
data_version:                          1
primary_key_bytes_in_memory:           2
primary_key_bytes_in_memory_allocated: 64
database:                              default
table:                                 53r93yleapyears
engine:                                MergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/53r93yleapyears/all_1_2_1/
column:                                id
type:                                  Int8
column_position:                       1
default_kind:
default_expression:
column_bytes_on_disk:                  76
column_data_compressed_bytes:          28
column_data_uncompressed_bytes:        2
column_marks_bytes:                    48
```

<div id="see-also">
  ## 관련 항목
</div>

* [MergeTree 엔진 계열](/ko/reference/engines/table-engines/mergetree-family/mergetree)
* [compact 및 wide 파트 수와 크기 계산](/ko/resources/support-center/knowledge-base/troubleshooting/count-parts-by-type)
