PostgreSQL 19 (RC 2) 코어 혁신 해부: 네이티브 REPACK (CONCURRENTLY)·논리적 디코딩 무중단 콤팩션·pg_plan_advice / pg_stash_advice 실행 계획 제어
2026년 11월 19일 정식 출시(GA)를 앞둔 PostgreSQL 19 (RC 2 기준)의 핵심 운영 혁신인 네이티브 REPACK (CONCURRENTLY)과 pg_plan_advice·pg_stash_advice 아키텍처를 분석한다. VACUUM FULL의 ACCESS EXCLUSIVE 락 차단과 pg_repack 트리거 오버헤드를 대체하는 논리적 디코딩 기반 2단계 스왑, pg_stat_progress_repack 모니터링, 선행 MVCC 스냅샷 가시성 주의사항, 그리고 QueryID 기반 실행 계획 고정과 로컬 Python 6대 검증을 정리한다.
PostgreSQL 19 네이티브 REPACK (CONCURRENTLY) 테이블 콤팩션 및 pg_plan_advice 실행 계획 제어 개념 추상 아트워크
대규모 프로덕션 PostgreSQL 클러스터를 운영하는 엔지니어가 가장 오랫동안 겪어온 두 가지 만성적 난제는 '서비스 무중단 테이블 블로트(Bloat) 회수'와 '메이저 업그레이드 또는 통계 변동 시 쿼리 실행 계획(Execution Plan) 회귀 방어'다. 기존에는 잦은 UPDATE와 DELETE로 비대해진 테이블의 죽은 튜플(Dead Tuple) 공간을 OS로 반환하려면 테이블 전체에 ACCESS EXCLUSIVE 락을 거는 VACUUM FULL이나 CLUSTER를 사용해 서비스를 사실상 멈추거나, 트리거와 로그 테이블을 수동으로 설치하는 서드파티 확장 pg_repack에 의존해야 했다. 마찬가지로 옵티마이저가 특정 조인 순서나 인덱스를 잘못 선택할 때도 PostgreSQL 코어에는 표준화된 플랜 고정(Plan Pinning) 메커니즘이 없어 pg_hint_plan 확장을 추가하고 애플리케이션 SQL에 주석 힌트를 직접 삽입해야 하는 부담이 컸다.
2026년 11월 12일 Release Candidate 2(RC 2)가 공개되고 11월 19일 정식 출시(GA)를 앞둔 PostgreSQL 19는 이 두 가지 엔터프라이즈 운영 숙제를 코어 엔진과 공식 contrib 모듈 수준에서 정면으로 해결했다. 첫째는 VACUUM FULL과 CLUSTER를 통합·대체하면서 온라인 무중단 재구성을 지원하는 네이티브 REPACK 명령과 REPACK (CONCURRENTLY) 옵션이며, 둘째는 SQL 수정 없이 실행 계획을 선언적으로 추출하고 QueryID 단위로 고정하는 pg_plan_advice 및 pg_stash_advice 모듈이다.
핵심 판단 기준을 먼저 요약하면, PostgreSQL 19의 REPACK (CONCURRENTLY)는 pg_repack처럼 테이블에 트리거를 걸지 않고 코어의 논리적 디코딩(Logical Decoding) 인프라와 내부 복제 슬롯(max_repack_replication_slots)을 활용해 복사 도중 발생하는 DML 변경분을 WAL에서 추적·리플레이한다. 데이터 복사 구간에서는 SHARE UPDATE EXCLUSIVE 락만 유지해 동시 읽기와 쓰기를 차단하지 않으며, 최종 relfilenode 교체 순간에만 짧은 ACCESS EXCLUSIVE 락을 획득해 디스크 공간을 OS에 반환한다. 단, 대상 테이블에는 반드시 Primary Key 또는 인덱스 기반 Replica Identity가 있어야 하며, REPACK (CONCURRENTLY) 시작 전에 획득된 장기 트랜잭션 스냅샷에서는 커밋 직후 테이블이 비어 보일 수 있는 MVCC 가시성 제약이 존재한다. 한편 pg_plan_advice는 EXPLAIN (PLAN_ADVICE)로 생성한 미니 언어 제약 문자열을 통해 옵티마이저를 대체하지 않고 후보 플랜 공간을 제약하며, pg_stash_advice는 이를 queryid에 바인딩해 Role/세션 단위로 자동 적용한다. 이 글은 공식 PostgreSQL 19 Documentation과 PostgreSQL 19 RC 2 Release Announcement를 교차 검증해 정리한 분석이며, 공식 명세와 로컬 Python 6대 시뮬레이션 검증을 기준으로 설명한다.
1. 네이티브 REPACK (CONCURRENTLY): 트리거 없는 무중단 테이블 콤팩션
PostgreSQL의 MVCC 아키텍처는 동시성을 높이는 대신 UPDATE와 DELETE 시 이전 버전의 행을 즉시 물리적으로 지우지 않고 Dead Tuple로 남긴다. 일반 VACUUM은 이 공간을 테이블 내부 재사용 목록(FSM)으로 돌릴 뿐 OS 파일 크기를 줄이지 못한다. PostgreSQL 19는 기존 VACUUM FULL과 CLUSTER를 단일 REPACK 구문으로 통합했다(CLUSTER 동작은 USING INDEX 절로 수행).
- 2단계 락 전이와 논리적 디코딩 기반 WAL 추적:
- Phase 1 (Bulk Copy):
REPACK (CONCURRENTLY)는 시작 시SHARE UPDATE EXCLUSIVE락(일반VACUUM,ANALYZE와 동일 레벨)만 획득한다. 따라서 애플리케이션의SELECT,INSERT,UPDATE,DELETE가 모두 정상 통과하는 상태에서 Live Tuple만 새relfilenode파일로 복사한다. - Phase 2 (Logical Decoding Buffer): 복사가 진행되는 동안 백그라운드 워커는 내부 복제 슬롯(
max_repack_replication_slots, 기본값 5)을 열어 대상 테이블에 발생하는 동시 DML을 WAL 논리적 디코딩으로 캡처한다. 서드파티pg_repack처럼 대상 테이블에 임시 트리거와 로그 테이블을 붙이지 않으므로 쓰기 경로의 트리거 오버헤드가 없다. - Phase 3 (Catch-up & Final Swap): 초기 복사가 끝나면 캡처한 WAL 변경분을 새 테이블 파일에 리플레이하고, 마지막 파일 교체(
relfilenodeswap)와 인덱스 재구축 마무리 시점에만 아주 짧은ACCESS EXCLUSIVE락을 획득해 교체를 완료한다.
- 실시간 진행률 관측 뷰
pg_stat_progress_repack: - PostgreSQL 19는
REPACK,CLUSTER,VACUUM FULL의 실행 단계와 처리 블록·튜플 수를 실시간으로 조회할 수 있는 pg_stat_progress_repack 시스템 뷰를 제공한다. - 장시간 실행되는 대용량 테이블 콤팩션에서 현재
scanning heap단계인지,replaying concurrent changes또는swapping relation files단계인지 즉시 파악할 수 있다.
2. 혼동하기 쉬운 4가지 기술 경계 및 운영 주의사항 비교
REPACK (CONCURRENTLY)와 pg_plan_advice는 강력하지만, 내부 동작 제약을 모르고 프로덕션에 적용하면 락 대기 큐 장애나 스냅샷 이상 현상을 만날 수 있다:
- 선행 스냅샷 트랜잭션의 MVCC 가시성 제약: 공식
sql-repack문서에 명시된 핵심 주의사항으로,REPACK (CONCURRENTLY)는 MVCC 스냅샷 관점에서 완전한 투명을 보장하지 않는다. 리팩이 시작되기 이전에 스냅샷을 확보한 동시 트랜잭션은 리팩 커밋 직후 해당 테이블을 조회할 때 테이블이 비어 있는 것처럼 관측할 수 있다. 장시간 유지되는REPEATABLE READ배치 트랜잭션이나 리포팅 쿼리와 겹치지 않도록 실행 창구를 분리해야 한다.
- Replica Identity 인덱스 필수 조건: 논리적 디코딩으로 변경 행을 식별해야 하므로 테이블에 Primary Key 또는
REPLICA IDENTITY USING INDEX로 지정된 non-deferrable 유니크 인덱스가 반드시 있어야 한다.REPLICA IDENTITY FULL이나NOTHING테이블, 언로그드(Unlogged) 테이블, 파티션 부모 테이블 직접 지정, 명시적 트랜잭션 블록(BEGIN ... END) 내부 실행은 모두 허용되지 않는다.
- 짧은
ACCESS EXCLUSIVE락의 큐잉 병목과lock_timeout: 복사 구간의 락은 가볍지만, 마지막 스왑 단계에서ACCESS EXCLUSIVE락을 기다리는 동안 장기 실행 쿼리가 테이블을 잡고 있으면 후속 애플리케이션 쿼리까지 줄줄이 락 대기 큐에 막힐 수 있다. 반드시 세션에SET lock_timeout = '2s';같은 안전장치를 걸고 실행해야 한다.
pg_plan_advice는 옵티마이저 대체가 아닌 '후보 제약 엔진': 기존pg_hint_plan과 달리 인라인 SQL 주석(/*+ ... */)을 요구하지 않는다.EXPLAIN (COSTS OFF, PLAN_ADVICE)로 현재 플랜의 어드바이스 문자열을 추출한 뒤, 플래너가 유효한 후보 집합 중 해당 제약을 어기는 경로만 배제하도록 강제한다.
| 비교 항목 | 기존 VACUUM FULL / CLUSTER | 서드파티 확장 pg_repack | PostgreSQL 19 REPACK (CONCURRENTLY) |
| 복사 중 테이블 락 | 전체 기간 ACCESS EXCLUSIVE (읽기/쓰기 전면 중단) | ACCESS SHARE / 짧은 ACCESS EXCLUSIVE | SHARE UPDATE EXCLUSIVE (동시 읽기/쓰기 무중단) |
| 동시 변경 추적 방식 | 불가능 (원천 차단) | 대상 테이블에 임시 트리거 + 로그 테이블 생성 | 코어 논리적 디코딩 + 내부 복제 슬롯 (트리거 없음) |
| 외부 확장 의존성 | 없음 (코어 내장) | 외부 확장 설치 및 클라이언트 바이너리 동기화 필요 | 없음 (표준 SQL 네이티브 명령 + pg_stat_progress_repack) |
| 필수 테이블 제약 | 없음 | Primary Key 또는 NOT NULL Unique Key | PK 또는 REPLICA IDENTITY USING INDEX (FULL 불가) |
| 필요 여유 디스크 | 테이블 + 인덱스 크기만큼 여유 공간 필수 | 테이블 + 인덱스 + 로그 테이블 여유 공간 | 테이블 + 인덱스 크기만큼 여유 공간 필수 |
3. PostgreSQL 19 코어 아키텍처 심층 분석: 온라인 리팩 & 플랜 거버넌스
PostgreSQL 19 REPACK (CONCURRENTLY) 논리적 디코딩 기반 3단계 무중단 콤팩션 파이프라인 및 pg_plan_advice / pg_stash_advice 플랜 고정 아키텍처 다이어그램
3.1 REPACK (CONCURRENTLY)의 물리 파일 교체와 병렬 오토배큠 시너지
PostgreSQL 19에서는 테이블 콤팩션뿐 아니라 일상적인 유지보수 계층도 함께 진화했다:
- 새로운
relfilenode할당과 공간 반환: REPACK은 기존 힙 파일의 빈 슬롯을 메우는 것이 아니라, 살아 있는 튜플만 압축해 새로운relfilenode파일을 생성하고 인덱스를 재구축한 뒤 카탈로그 포인터를 원자적으로 스왑한다.- 스왑 직후 구 파일이 언링크되므로 조각화(Fragmentation)가 완전히 제거되고 운영체제 파일시스템에 여유 용량이 즉시 반환된다.
- Parallel Autovacuum 및 우선순위 스코어링:
- PostgreSQL 19 Release Notes에 따르면, 오토배큠 워커가 다중 인덱스를 병렬로 처리할 수 있게 되었고 테이블 긴급도를 산정하는 새로운 스코어링 시스템이 도입되어 대용량 OLTP 테이블에서
REPACK이 필요한 수준의 극심한 블로트가 쌓이는 빈도 자체를 낮춘다.
3.2 pg_plan_advice와 pg_stash_advice: SQL 무수정 플랜 거버넌스
실무에서 가장 치명적인 장애 중 하나는 PostgreSQL 메이저 버전 업그레이드(예: PG 16 → PG 19) 직후 특정 핵심 쿼리의 실행 계획이 Nested Loop에서 Seq Scan + Hash Join으로 뒤집히며 전체 DB CPU가 100%로 치솟는 현상이다. PostgreSQL 19는 이를 두 단계의 공식 contrib 모듈로 방어한다:
pg_plan_advice미니 언어 추출 및 세션 검증:EXPLAIN (COSTS OFF, PLAN_ADVICE)를 실행하면 플래너가 선택한 조인 순서(JOIN_ORDER(c o)), 조인 연산자(HASH_JOIN(o),NESTED_LOOP_MEMOIZE(o)), 스캔 방식(INDEX_SCAN(o idx_orders_customer)), 병렬 여부(NO_GATHER(c o))가 구조화된 문자열로 출력된다.- DBA는 애플리케이션 코드를 배포하지 않고도
SET pg_plan_advice.advice = '...'로 대안 플랜의 성능을 즉시 A/B 검증할 수 있다.
pg_stash_advice를 통한 QueryID 단위 영구 고정:- 검증된 어드바이스 문자열을
pg_create_advice_stash('production_stash')로 만든 스태시에pg_set_stashed_advice('production_stash', queryid, advice)로 등록한다. - 이후
ALTER ROLE app_user SET pg_stash_advice.stash_name = 'production_stash';를 설정하면,app_user가 해당queryid의 SQL을 호출할 때마다 코어 플래너가 자동으로 스태시된 제약을 적용한다.
4. 실무 SQL 예제와 로컬 Python 6대 아키텍처 검증 스크립트
4.1 PostgreSQL 19 실무 적용 SQL 워크플로우
아래 SQL은 프로덕션 환경에서 안전하게 REPACK (CONCURRENTLY)를 실행·모니터링하고, 핵심 쿼리의 실행 계획을 pg_stash_advice로 고정하는 실무 패턴이다:
4.2 로컬 Python 6대 핵심 불변식 검증 스크립트
아래 Python 스크립트는 PostgreSQL 19의 6대 핵심 메커니즘(Dead Tuple 회수 및 relfilenode 교체, Replica Identity·트랜잭션 블록·파티션·슬롯·디스크 가드, 2단계 락 전이 및 논리적 디코딩 WAL 리플레이·lock_timeout 방어, pg_stat_progress_repack 단계 추적 및 선행 스냅샷 MVCC 주의사항, pg_plan_advice 제약 강제, pg_stash_advice QueryID/Role 바인딩)을 로컬 환경에서 외부 패키지 없이 재현·검증한다:
실행 결과:
5. 실무 도입 및 PostgreSQL 19 마이그레이션 체크리스트
대상 테이블의 Replica Identity 및 여유 디스크 사전 점검: REPACK (CONCURRENTLY) 대상 테이블에 Primary Key 또는 REPLICA IDENTITY USING INDEX가 설정되어 있는지 확인하고, 테이블과 인덱스 합산 크기 이상의 여유 디스크 공간과 max_repack_replication_slots 여유 슬롯을 확보한다.
lock_timeout 설정 및 배치 트랜잭션 분리: 최종 relfilenode 스왑 시 장기 쿼리에 의한 락 대기 큐 적체를 막기 위해 반드시 SET lock_timeout을 지정하고, 리팩 시작 전부터 열려 있는 장기 스냅샷 트랜잭션이 없는 유지보수 시간대에 실행한다.
파티션 테이블 리프 단위 순회 스크립트 전환: 기존 pg_repack이나 VACUUM FULL 스크립트를 부모 파티션 테이블에 직접 실행하던 경우, PostgreSQL 19에서는 개별 리프 파티션 목록을 조회해 순차 실행하도록 전환한다.
pg_stat_progress_repack 모니터링 대시보드 연동: 장시간 테이블 재구성 작업의 진행 단계(phase)와 heap_tuples_written 진행률을 기존 pg_stat_progress_vacuum 알림 체계에 통합한다.
업그레이드 전 핵심 쿼리 PLAN_ADVICE 베이스라인 수집: PostgreSQL 19 전환 및 QA 과정에서 핵심 OLTP 쿼리의 EXPLAIN (COSTS OFF, PLAN_ADVICE) 문자열과 queryid를 사전 확보해 플랜 회귀 시 즉시 pg_stash_advice로 복구할 수 있는 런북을 준비한다.
호환성 및 보안 변경사항 점검: PostgreSQL 19 RC 2에서 제거된 UDP 기반 RADIUS 인증, MD5 비밀번호 로그인 경고, standard_conforming_strings 강제 활성화, 그리고 표현식 인덱스 내 일부 JSON_ARRAY/JSON_OBJECT 제약 변경이 기존 스키마와 충돌하지 않는지 pg_upgrade --check로 사전 검증한다.
6. 참고 자료 및 공식 출처 (2026-11-17 확인)
확인 기준일: November 17, 2026