메인 콘텐츠로 건너뛰기

설명

MergeTree 테이블의 파트에 관한 정보를 포함합니다. 각 행은 하나의 데이터 파트를 나타냅니다.

컬럼

  • partition (String) — 파티션 식별자(테이블 파티션 키 표현식에서 파생된 문자열 표현).
  • name (String) — 데이터 파트의 이름입니다. 파트 명명 구조를 사용하면 데이터, 수집, 머지 패턴의 여러 특성을 파악할 수 있습니다. 파트 명명 포맷은 다음과 같습니다:
<partition_id>_<minimum_block_number>_<maximum_block_number>_<level>_<data_version>
  • 정의:
    • partition_id - 파티션 키를 식별합니다
    • minimum_block_number - 파트의 최소 block 번호를 식별합니다. ClickHouse는 항상 연속된 block을 머지합니다
    • maximum_block_number - 파트의 최대 block 번호를 식별합니다
    • level - 파트에서 추가 머지가 발생할 때마다 1씩 증가합니다. level이 0이면 아직 머지되지 않은 새 파트임을 나타냅니다. ClickHouse의 모든 파트는 항상 변경 불가능하다는 점을 기억하는 것이 중요합니다
    • data_version - 선택적 값으로, 파트가 변경되면 증가합니다(즉, 파트는 변경 불가능하므로 변경된 데이터는 항상 새 파트에만 기록됩니다)
  • uuid (UUID) — 데이터 파트의 UUID입니다.
  • part_type (String) — 데이터 파트(data part)의 저장 포맷입니다. 가능한 값: Wide — 각 컬럼이 별도의 파일에 저장됩니다. Compact — 모든 컬럼이 하나의 파일에 저장됩니다. 데이터 저장 포맷은 MergeTree 테이블의 min_bytes_for_wide_partmin_rows_for_wide_part 설정으로 제어됩니다.
  • active (UInt8) — 데이터 파트가 활성 상태인지 나타내는 플래그입니다. 데이터 파트가 활성 상태이면 테이블에서 사용 중입니다. 그렇지 않으면 곧 삭제됩니다. 비활성 데이터 파트는 병합 및 변경(mutation) 작업 후에 나타납니다.
  • marks (UInt64) — 마크 수입니다. 데이터 파트(data part)의 대략적인 행 수를 구하려면 marks에 인덱스 세분화 수준(보통 8192)을 곱하십시오(이 방법은 adaptive granularity에는 적용되지 않습니다).
  • rows (UInt64) — 행의 개수입니다.
  • files (UInt64) — 데이터 파트 내 파일 수입니다.
  • bytes_on_disk (UInt64) — 모든 데이터 파트 파일의 총 크기(바이트)입니다.
  • data_compressed_bytes (UInt64) — 데이터 파트에 있는 압축 데이터의 총 크기입니다. 모든 보조 파일(예: 마크 파일)은 포함되지 않습니다.
  • data_uncompressed_bytes (UInt64) — 데이터 파트(data part)에 있는 비압축 데이터의 총 크기입니다. 모든 보조 파일(예: 마크 파일)은 포함되지 않습니다.
  • primary_key_size (UInt64) — 디스크의 primary.idx/cidx 파일에 있는 기본 키 값이 사용하는 메모리 크기(바이트 단위)입니다.
  • marks_bytes (UInt64) — 마크 파일의 크기입니다.
  • secondary_indices_compressed_bytes (UInt64) — 데이터 파트(data part)에서 보조 인덱스의 압축 데이터 전체 크기입니다. 마크가 있는 파일과 같은 모든 보조 파일은 포함되지 않습니다.
  • secondary_indices_uncompressed_bytes (UInt64) — 데이터 파트(data part)의 보조 인덱스에 대한 비압축 데이터의 총 크기입니다. 마크가 있는 파일과 같은 모든 보조 파일은 포함되지 않습니다.
  • secondary_indices_marks_bytes (UInt64) — 보조 인덱스의 마크 파일 크기입니다.
  • modification_time (DateTime) — 데이터 파트가 저장된 디렉터리의 수정 시각입니다. 일반적으로 데이터 파트가 생성된 시각과 일치합니다.
  • remove_time (DateTime) — 데이터 파트가 비활성화된 시각입니다.
  • refcount (UInt32) — 데이터 파트(data part)가 사용되는 곳의 수입니다. 값이 2보다 크면 해당 데이터 파트가 쿼리 또는 머지에 사용되고 있음을 의미합니다.
  • min_date (Date) — 데이터 파트에서 date 키의 최솟값입니다.
  • max_date (Date) — 데이터 파트의 날짜 키의 최댓값입니다.
  • min_time (DateTime) — 데이터 파트의 날짜 및 시간 키 최솟값입니다.
  • max_time (DateTime) — 데이터 파트에서 날짜 및 시간 키의 최댓값입니다.
  • partition_id (String) — 파티션 ID입니다.
  • min_block_number (Int64) — 병합 후 현재 파트를 구성하는 데이터 파트들 중 가장 작은 번호입니다.
  • max_block_number (Int64) — 병합 후 현재 파트를 구성하는 데이터 파트들 중 가장 큰 번호입니다.
  • level (UInt32) — MergeTree의 깊이입니다. 0은 현재 파트가 다른 파트들을 머지해서 생성된 것이 아니라 삽입으로 생성되었음을 의미합니다.
  • data_version (UInt64) — 데이터 파트에 어떤 뮤테이션을 적용할지 결정하는 데 사용되는 숫자(data_version보다 버전이 높은 뮤테이션).
  • primary_key_bytes_in_memory (UInt64) — 기본 키 값에 사용되는 메모리 양(바이트)입니다. primary_key_lazy_load가 활성화되어 있고 키가 로드되지 않은 경우에는 0이 됩니다. 0이 아닌 경우, 해당 바이트는 파트 자체에 존재하며 jemalloc.mergetree_arena.active_bytes에 포함되어 집계됩니다. 이 바이트는 PrimaryIndexCacheBytes에는 절대 포함되지 않습니다 — 파트별로 둘은 서로 배타적입니다. 즉, primary_key_lazy_loaduse_primary_key_cache 설정에 따라 인덱스는 파트(이 메트릭) 또는 공유 PrimaryIndexCache(다른 메트릭) 중 한 곳에만 존재합니다.
  • primary_key_bytes_in_memory_allocated (UInt64) — 기본 키 값에 대해 예약된 메모리 양(바이트)입니다. primary_key_lazy_load가 활성화되어 있고 키가 로드되지 않은 경우 0입니다. 0이 아닌 경우 jemalloc.mergetree_arena.active_bytes에 포함됩니다. PrimaryIndexCacheBytes와의 관계는 primary_key_bytes_in_memory의 참고 사항을 참조하십시오.
  • index_granularity_bytes_in_memory (UInt64) — 인덱스 세분화 수준 값에 사용되는 메모리 양(바이트)입니다(primary&#95;key&#95;lazy&#95;load=1use&#95;primary&#95;key&#95;cache=1인 경우 0이 됨). 0이 아닌 경우 해당 바이트는 부분 소유로 처리되며 jemalloc.mergetree_arena.active_bytes에 포함되어 집계됩니다.
  • index_granularity_bytes_in_memory_allocated (UInt64) — 인덱스 세분화 수준 값에 예약된 메모리 크기(바이트 단위)입니다(primary&#95;key&#95;lazy&#95;load=1use&#95;primary&#95;key&#95;cache=1인 경우 0입니다). 0이 아닌 경우 jemalloc.mergetree_arena.active_bytes에 포함됩니다.
  • is_frozen (UInt8) — 파티션 데이터의 백업 존재 여부를 나타내는 플래그입니다. 1이면 백업이 존재합니다. 0이면 백업이 존재하지 않습니다. 자세한 내용은 FREEZE PARTITION을 참조하십시오.
  • database (String) — 데이터베이스 이름입니다.
  • table (String) — 테이블 이름입니다.
  • engine (String) — 매개변수 없이 지정한 테이블 엔진의 이름입니다.
  • disk_name (String) — 데이터 파트를 저장하는 디스크 이름입니다.
  • path (String) — 데이터 파트 파일이 저장된 폴더의 절대 경로입니다.
  • hash_of_all_files (String) — 압축 파일의 sipHash128 해시입니다.
  • hash_of_uncompressed_files (String) — 압축되지 않은 파일(마크가 포함된 파일, 인덱스 파일 등)의 sipHash128입니다.
  • uncompressed_hash_of_compressed_files (String) — 압축 파일의 데이터를 압축되지 않은 상태인 것처럼 간주했을 때의 sipHash128입니다.
  • delete_ttl_info_min (DateTime) — TTL DELETE 규칙의 날짜 및 시간 키 최솟값입니다.
  • delete_ttl_info_max (DateTime) — TTL DELETE 규칙의 날짜/시간 키 최댓값입니다.
  • move_ttl_info.expression (Array(String)) — 표현식 배열입니다. 각 표현식은 TTL 이동 규칙을 정의합니다.
  • move_ttl_info.min (Array(DateTime)) — 날짜 및 시간 값으로 이루어진 배열입니다. 각 요소는 TTL MOVE 규칙의 최소 키 값을 나타냅니다.
  • move_ttl_info.max (Array(DateTime)) — 날짜 및 시간 값의 배열입니다. 각 요소는 TTL 이동 규칙의 최대 키 값을 나타냅니다.
  • default_compression_codec (String) — 이 데이터 part를 압축하는 데 사용되는 코덱 이름입니다(컬럼에 명시적으로 코덱이 지정되지 않은 경우).
  • recompression_ttl_info.expression (배열(String)) — TTL 표현식.
  • recompression_ttl_info.min (Array(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최솟값입니다. 만료된 TTL이 적용된 행이 하나 이상 있는지 확인하는 데 사용됩니다.
  • recompression_ttl_info.max (Array(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최댓값입니다. TTL이 만료된 모든 행이 포함되어 있는지 확인하는 데 사용됩니다.
  • group_by_ttl_info.expression (배열(String)) — TTL 표현식입니다.
  • group_by_ttl_info.min (Array(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최솟값입니다. TTL이 만료된 행이 하나 이상 있는지 확인하는 데 사용됩니다.
  • group_by_ttl_info.max (배열(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최댓값입니다. TTL이 만료된 모든 행이 포함되어 있는지 파악하는 데 사용됩니다.
  • rows_where_ttl_info.expression (Array(String)) — TTL 표현식.
  • rows_where_ttl_info.min (Array(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최솟값입니다. TTL이 만료된 행이 하나 이상 있는지 확인하는 데 사용됩니다.
  • rows_where_ttl_info.max (Array(DateTime)) — 이 파트에서 계산된 TTL 표현식의 최댓값입니다. TTL이 만료된 모든 행이 포함되어 있는지 확인하는 데 사용됩니다.
  • projections (Array(String)) — 이 파트에 대해 계산된 프로젝션 이름 목록입니다.
  • visible (UInt8) — SELECT 쿼리에서 이 파트가 표시되는지 여부를 나타내는 플래그입니다.
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — 이 객체를 생성했거나 생성을 시도 중인 트랜잭션의 ID입니다.
  • removal_tid_lock (UInt64) — 객체를 제거할 때 잠그는 데 사용되는 removal_tid의 해시입니다.
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — 이 객체를 제거했거나 제거를 시도 중인 transaction의 ID
  • creation_csn (UInt64) — 이 객체를 생성한 transaction의 CSN
  • removal_csn (UInt64) — 이 객체를 삭제한 트랜잭션의 CSN
  • has_lightweight_delete (UInt8) — 파트에 경량한 삭제 마스크가 있는지 여부를 나타내는 플래그입니다.
  • last_removal_attempt_time (DateTime) — 서버가 이 part를 마지막으로 삭제 시도한 시간입니다.
  • removal_state (String) — part 삭제 프로세스의 현재 상태입니다.

예시

SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;
Row 1:
──────
partition:                             tuple()
name:                                  all_1_4_1_6
part_type:                             Wide
active:                                1
marks:                                 2
rows:                                  6
bytes_on_disk:                         310
data_compressed_bytes:                 157
data_uncompressed_bytes:               91
secondary_indices_compressed_bytes:    58
secondary_indices_uncompressed_bytes:  6
secondary_indices_marks_bytes:         48
marks_bytes:                           144
modification_time:                     2020-06-18 13:01:49
remove_time:                           1970-01-01 00:00:00
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
min_time:                              1970-01-01 00:00:00
max_time:                              1970-01-01 00:00:00
partition_id:                          all
min_block_number:                      1
max_block_number:                      4
level:                                 1
data_version:                          6
primary_key_bytes_in_memory:           8
primary_key_bytes_in_memory_allocated: 64
is_frozen:                             0
database:                              default
table:                                 months
engine:                                MergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/months/all_1_4_1_6/
hash_of_all_files:                     2d0657a16d9430824d35e327fcbd87bf
hash_of_uncompressed_files:            84950cc30ba867c77a408ae21332ba29
uncompressed_hash_of_compressed_files: 1ad78f1c6843bbfb99a2c931abe7df7d
delete_ttl_info_min:                   1970-01-01 00:00:00
delete_ttl_info_max:                   1970-01-01 00:00:00
move_ttl_info.expression:              []
move_ttl_info.min:                     []
move_ttl_info.max:                     []

관련 항목

마지막 수정일 2026년 6월 10일