파티셔닝 — RANGE·LIST·HASH

1억 행 테이블에서 "이번 달 데이터만" 을 매번 검색하면 인덱스가 있어도 무겁습니다. 파티셔닝은 테이블을 물리적으로 여러 조각으로 나누어, 쿼리가 필요한 조각만 만지게 합니다. 22편은 PG 의 3가지 파티션 방식과 시계열 데이터 패턴.

왜 파티셔닝? — 4가지 이유

• 쿼리 성능 — 필요한 파티션만 스캔(partition pruning).
• 유지보수 — 옛 파티션 통째로 DROP (1초). DELETE 보다 압도적.
• 인덱스 크기 — 파티션별 인덱스가 작아 캐시 효율 ↑.
• 병렬 처리 — 파티션 단위로 병렬 스캔·VACUUM.

3가지 파티션 방식

RANGE — 월별 시계열

-- 1) 파티션 부모 테이블
CREATE TABLE events (
  id          BIGSERIAL,
  user_id     BIGINT,
  event_type  TEXT,
  payload     JSONB,
  created_at  TIMESTAMPTZ NOT NULL,
  PRIMARY KEY (id, created_at)         -- 파티션 키를 PK 에 포함 필수
) PARTITION BY RANGE (created_at);

-- 2) 월별 파티션
CREATE TABLE events_2026_01 PARTITION OF events
  FOR VALUES FROM ('2026-01-01') TO ('2026-02-01');

CREATE TABLE events_2026_02 PARTITION OF events
  FOR VALUES FROM ('2026-02-01') TO ('2026-03-01');

CREATE TABLE events_2026_03 PARTITION OF events
  FOR VALUES FROM ('2026-03-01') TO ('2026-04-01');

-- INSERT 는 부모에 — Postgres 가 자동으로 알맞은 파티션에
INSERT INTO events (...) VALUES (...);

-- SELECT 도 부모에
SELECT * FROM events WHERE created_at >= '2026-02-15';
-- → events_2026_02 와 그 이후만 스캔 (partition pruning)

LIST — 지역별

CREATE TABLE orders_regional (
  id      BIGSERIAL,
  region  TEXT NOT NULL,
  total   NUMERIC,
  PRIMARY KEY (id, region)
) PARTITION BY LIST (region);

CREATE TABLE orders_kr PARTITION OF orders_regional FOR VALUES IN ('KR');
CREATE TABLE orders_jp PARTITION OF orders_regional FOR VALUES IN ('JP');
CREATE TABLE orders_us PARTITION OF orders_regional FOR VALUES IN ('US', 'CA');

-- 나머지
CREATE TABLE orders_other PARTITION OF orders_regional DEFAULT;

HASH — 균등 분산

CREATE TABLE users_h (
  id    BIGINT NOT NULL,
  name  TEXT,
  PRIMARY KEY (id)
) PARTITION BY HASH (id);

-- 4개 파티션 (0, 1, 2, 3)
CREATE TABLE users_h_0 PARTITION OF users_h FOR VALUES WITH (MODULUS 4, REMAINDER 0);
CREATE TABLE users_h_1 PARTITION OF users_h FOR VALUES WITH (MODULUS 4, REMAINDER 1);
CREATE TABLE users_h_2 PARTITION OF users_h FOR VALUES WITH (MODULUS 4, REMAINDER 2);
CREATE TABLE users_h_3 PARTITION OF users_h FOR VALUES WITH (MODULUS 4, REMAINDER 3);

파티션 인덱스 — 부모에 만들면 모두 상속

-- 부모에 인덱스 → 모든 파티션에 자동
CREATE INDEX ix_events_user ON events (user_id);

-- 또는 파티션별 개별 인덱스
CREATE INDEX ix_events_2026_01_user ON events_2026_01 (user_id);

-- UNIQUE 제약은 파티션 키를 포함해야 함
CREATE UNIQUE INDEX uq_events_id ON events (id, created_at);

partition pruning 확인 — EXPLAIN

EXPLAIN SELECT * FROM events WHERE created_at >= '2026-03-01';

-- 결과
-- Append
--   -> Seq Scan on events_2026_03   ← 이것만!
-- (다른 파티션은 안 나타남 → pruning 성공)

파티션 관리 — 추가·삭제

-- 새 달 파티션 추가
CREATE TABLE events_2026_04 PARTITION OF events
  FOR VALUES FROM ('2026-04-01') TO ('2026-05-01');

-- 옛 파티션 분리 (백업·아카이브용)
ALTER TABLE events DETACH PARTITION events_2025_01;
-- 분리된 테이블은 일반 테이블 — 백업 후 DROP

-- 또는 즉시 삭제
DROP TABLE events_2025_01;   -- 1초 (DELETE 와 비교 불가)

pg_partman — 파티션 자동 관리

CREATE EXTENSION pg_partman;

-- 자동으로 매월 새 파티션 만들고 옛 것 정리
SELECT partman.create_parent(
  p_parent_table  := 'public.events',
  p_control       := 'created_at',
  p_type          := 'range',
  p_interval      := '1 month',
  p_premake       := 4              -- 4개월 미리 만들기
);

-- cron 또는 pg_cron 으로 주기 실행
SELECT partman.run_maintenance();   -- 새 파티션 + 옛 것 정리

실전 — 시계열 데이터 패턴

-- 1) 월별 RANGE 파티션
CREATE TABLE metrics (
  ts      TIMESTAMPTZ NOT NULL,
  device  TEXT NOT NULL,
  value   DOUBLE PRECISION
) PARTITION BY RANGE (ts);

-- 2) BRIN 인덱스 (16편 — 시계열에 최적)
CREATE INDEX ix_metrics_ts ON metrics USING BRIN (ts);

-- 3) pg_partman 자동 관리

-- 4) 90일 보관 후 자동 삭제
SELECT partman.create_parent(
  ...,
  p_premake := 3,
  p_retention := '90 days',
  p_retention_keep_table := false   -- detach 가 아니라 drop
);

제약 — 알아두면 좋은 5가지