12장. 파티셔닝 — 거대한 테이블을 서랍장으로

10억 행짜리 테이블은 "느린 것"이 문제가 아니라 "관리 불가능한 것"이 문제입니다. 테이블을 월별 서랍으로 나누면 쿼리는 필요한 서랍만 열고, 오래된 서랍은 통째로 버릴 수 있습니다.

12.1 왜 파티셔닝인가 — 성능보다 먼저 "운영 가능성"

단일 테이블이 수억 행을 넘어가면 세 가지 문제가 동시에 옵니다: VACUUM이 한 바퀴 도는 데 몇 시간(autovacuum이 못 따라감), 인덱스가 거대해져 REINDEX가 부담, 그리고 "3개월 지난 로그 삭제" 같은 대량 DELETE가 Bloat 폭탄이 됩니다.

파티셔닝(Partitioning)은 하나의 논리 테이블을 물리적으로 여러 자식 테이블(파티션)로 나누는 표준 기법입니다. 앱은 여전히 logs 하나에 쿼리하지만, 실제 데이터는 logs_2024_01, logs_2024_02… 로 나뉘어 저장됩니다.

12.2 Declarative Partitioning — RANGE / LIST / HASH

v10부터 도입된 Declarative Partitioning이 현재 표준입니다. 파티션 키를 테이블 정의에 선언하면 INSERT 라우팅을 엔진이 알아서 합니다. (v9 시절의 상속+트리거 방식은 유지비용이 극심해 신규 도입 이유가 없습니다.)

-- RANGE: 시간/ID 범위 — 가장 일반적
CREATE TABLE orders (
    order_id   bigserial,
    created_at timestamptz NOT NULL,
    amount     numeric(12,2),
    PRIMARY KEY (order_id, created_at)   -- ⚠️ PK에 파티션 키 포함 필수!
) PARTITION BY RANGE (created_at);

CREATE TABLE orders_2024_q1 PARTITION OF orders
    FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');  -- [from, to) 반개구간

-- LIST: 이산 값 (국가, 테넌트)
CREATE TABLE events_kr PARTITION OF events FOR VALUES IN ('KR');
CREATE TABLE events_etc PARTITION OF events DEFAULT;      -- 캐치올 (v11+)

-- HASH: 균등 분산 (v11+) — 등가 조건(=)에서만 pruning!
CREATE TABLE users_p0 PARTITION OF users
    FOR VALUES WITH (MODULUS 4, REMAINDER 0);

12.3 Partition Pruning — 필요한 서랍만 연다

파티셔닝의 쿼리 성능 이득은 대부분 Pruning(가지치기)에서 나옵니다. 플래너가 WHERE 조건을 각 파티션의 범위와 비교해서, 관련 없는 파티션을 스캔 대상에서 아예 제외하는 것입니다.

-- Pruning 확인: Append 아래 파티션이 하나만 나오면 성공
EXPLAIN SELECT count(*) FROM orders
WHERE created_at >= '2024-06-01' AND created_at < '2024-07-01';
--  Aggregate
--    ->  Seq Scan on orders_2024_q2    ← 1개만 스캔!

-- ❌ Pruning 실패: 함수 래핑
SELECT * FROM orders WHERE to_char(created_at, 'YYYY-MM') = '2024-06';

12.4 월별 로테이션 — 파티션의 일생

시계열 파티션 운영의 정석은 "미리 만들고, 오래되면 분리해서 버린다"는 컨베이어 벨트입니다. 순정 PostgreSQL은 파티션을 자동으로 만들어주지 않으므로, 이 로테이션을 cron/pg_cron 또는 pg_partman으로 자동화합니다.

-- pg_partman으로 로테이션 자동화 (13장 참조)
SELECT partman.create_parent(
    p_parent_table => 'public.logs',
    p_control      => 'ts',
    p_interval     => 'daily',
    p_premake      => 7            -- 7일치 미리 생성
);
-- pg_cron으로 주기 실행
CALL partman.run_maintenance_proc();

12.5 함정 총정리 — 도입 전 체크

✍️ 이해도 체크