4장. Table Parts — 파트 구조

MergeTree의 모든 것은 "파트"에서 시작합니다. INSERT가 디렉터리 하나를 만들어내는 순간부터, 그 안의 column.bin·마크·인덱스가 SELECT를 움직이는 방식까지.

4.1 파트란 무엇인가 — immutable한 최소 물리 단위

MergeTree 엔진 패밀리에서 테이블 데이터는 디스크 위에 immutable한 data part들의 집합으로 조직됩니다. 파트 하나 = 디스크의 디렉터리 하나입니다.

핵심 키워드는 immutable(불변)입니다. 파트는 생성되고 삭제될 수는 있어도, 한 번 만들어진 내용은 절대 수정되지 않습니다. 이 단순한 성질 하나가 많은 것을 공짜로 만들어 줍니다.

• 동시성: INSERT는 새 파트만 만들므로 실행 중인 SELECT와 충돌하지 않습니다.
• 스냅샷 격리: SELECT는 쿼리 시작 시점의 파트 집합만 바라봅니다.
• 장애 복구: 파트 단위로 복사·복원이 가능합니다.

4.2 INSERT의 4단계 — 파트가 태어나는 과정

이 장 전체에서 사용할 예시 테이블입니다.

CREATE TABLE uk.uk_price_paid_simple
(
    date   Date,
    town   LowCardinality(String),
    street LowCardinality(String),
    price  UInt32
)
ENGINE = MergeTree
ORDER BY (town, street);   -- sorting key = 파트 내부의 정렬 순서

4.3 파트 디렉터리 해부 — 세 종류의 핵심 파일

이 밖에도 secondary skipping index, 컬럼 통계, 체크섬, (파티셔닝 시) min-max 인덱스 등이 같은 디렉터리에 들어갑니다. 이제 SELECT가 이 파일들을 어떤 순서로 사용하는지 봅시다.

4.4 파트 이름 읽는 법 — all_0_5_1의 의미

-- 파트 디렉터리 이름의 구조
all_0_5_1
 │  │ │ └── merge level (1 = 한 번 머지됨, 0 = 갓 INSERT됨)
 │  │ └──── max block number
 │  └────── min block number
 └───────── partition 이름 ("all" = 파티셔닝 미사용)

즉 all_0_5_1은 "블록 0~5번을 포함하며, 머지를 1번 거친 파트"입니다. level이 높을수록 더 많은 머지를 거친 큰 파트입니다.

4.5 파트의 생명주기 — 태어나고, 합쳐지고, 사라지기까지

백그라운드 머지는 파트를 설정 가능한 최대 압축 크기(max_bytes_to_merge_at_max_space_in_pool, 기본 약 150GB)까지 키웁니다. 이 크기에 도달한 파트는 더 이상 머지 대상이 아니므로, 시간이 지나면 파트 수가 자연스럽게 안정화됩니다. 다만 동일 데이터가 INSERT 때 한 번, 머지 때 또 한 번 쓰이는 write amplification(쓰기 증폭)은 피할 수 없는 트레이드오프입니다 — 읽기 최적화를 위한 대가입니다.

4.6 파트 관찰하기 — system.parts

-- 가상 컬럼 _part로 어떤 파트에서 읽었는지 확인
SELECT _part FROM uk.uk_price_paid_simple GROUP BY _part ORDER BY _part;

-- 파트 상세: level이 높을수록 머지를 많이 거친 파트
SELECT name, level, rows, bytes_on_disk, modification_time
FROM system.parts
WHERE database = 'uk' AND `table` = 'uk_price_paid_simple' AND active
ORDER BY name;

-- 테이블별 활성 파트 수 — "Too many parts" 위험 감지
SELECT database, `table`, count() AS active_parts,
       formatReadableSize(sum(bytes_on_disk)) AS total_size
FROM system.parts
WHERE active
GROUP BY database, `table`
ORDER BY active_parts DESC;

✍️ 이해도 체크