10장. 피해야 할 패턴들 — 안티패턴 모음

MySQL·PostgreSQL에서 하던 습관을 ClickHouse에 그대로 가져오는 순간 성능은 무너집니다. 공식 best-practices가 명시적으로 경고하는 7가지 안티패턴을 "왜 위험한지"부터 대안까지 정리합니다.

10.1 Mutation 남용 — ALTER TABLE UPDATE/DELETE

ClickHouse에도 ALTER TABLE ... UPDATE / DELETE 구문이 있습니다. SQL 문법은 낯익지만, 내부 동작은 OLTP DB와 근본적으로 다릅니다. 공식 문서의 표현: "행을 제자리에서 수정하는 대신, mutation은 변경의 영향을 받는 데이터 파트 전체를 다시 쓰는 비동기 백그라운드 프로세스다."

4장에서 배운 대로 파트는 불변(immutable)입니다. 그래서 단 한 행을 고치려 해도 그 행이 든 파트 전체를 재작성해야 합니다.

-- 피하라: 행 몇 개 때문에 파트 전체 재작성
ALTER TABLE mytable UPDATE status = 'inactive' WHERE user_id = 123;
ALTER TABLE mytable DELETE WHERE date < '2023-01-01';

-- 대안 1: ReplacingMergeTree에 새 행 INSERT (UPDATE 대체)
INSERT INTO mytable VALUES (123, 'inactive', now());

-- 대안 2: Lightweight Delete — 파트를 다시 쓰지 않고 마스크 파일로 처리
DELETE FROM mytable WHERE user_id = 123;

-- 대안 3: 대량 삭제는 파티션 단위로 (초 단위 완료)
ALTER TABLE mytable DROP PARTITION '2022-01-01';

10.2 OPTIMIZE TABLE FINAL 남용

OPTIMIZE TABLE ... FINAL은 모든 활성 파트를 하나의 파트로 강제 머지하는 명령입니다. "머지를 빨리 끝내면 좋은 것 아닌가?"라고 생각하기 쉽지만, 공식 문서가 별도 문서("Avoid OPTIMIZE FINAL")로 경고하는 대표 안티패턴입니다.

10.3 나머지 안티패턴 — 습관이 부르는 성능 저하

-- 피하라: Nullable + 넓은 타입 + 일반 String
CREATE TABLE t_bad (
    x    Int64,
    y    Nullable(Int8),
    town String,
    ts   DateTime64
) ENGINE = MergeTree ORDER BY x;

-- 권장: 적정 타입 + DEFAULT + LowCardinality + Date
CREATE TABLE t_good (
    x    UInt16,
    y    Int8 DEFAULT 0,
    town LowCardinality(String),
    d    Date
) ENGINE = MergeTree ORDER BY x;

10.4 총정리 — 안티패턴 → 대안 매핑

✍️ 이해도 체크