읽는 데 7분
REPACK을 시작할 빈 디스크는 얼마나 필요할까
디스크를 돌려받으려고 실행하는 명령인데, 시작하려면 빈 디스크가 더 필요해요. PostgreSQL 19의 REPACK은 새 테이블과 모든 인덱스의 복사본을 만들기 때문에 테이블과 인덱스 크기의 합만큼 여유 공간이 필요해요. 인덱스 순서로 정렬하는 경로를 택하면 정렬 파일 공간도 추가될 수 있어요.
Snowflake의 소개와 이를 옮긴 한국어 요약은 '2배 공간'을 요구 조건으로 설명해요. 정식 매뉴얼을 대조해 보면, 운영 전에 계산할 항목은 복사본 하나에서 끝나지 않아요. 여기서는 성능이나 락을 직접 시험하지 않고, 문서의 조건을 공간 예산으로 나눠 봤어요.
지금 쓰는 공간과 추가로 필요한 공간
REPACK은 불필요해진 옛 행을 제외하고 테이블을 새 파일로 다시 써서, 남는 공간을 운영체제에 돌려주는 명령이에요. 기존 데이터를 지우고 그 자리에 덮어쓰는 방식이 아니라 새 복사본이 생겨요.
가령 테이블이 100GiB이고 모든 인덱스의 합이 40GiB라고 해 볼게요. 아래는 실제 측정이 아닌, 매뉴얼의 요구량에 대입한 계산이에요.
| 작업 경로 | 추가 여유 공간을 잡는 항목 | 예시 계산 |
|---|---|---|
| 테이블과 인덱스 다시 쓰기 | 테이블 + 모든 인덱스 | 100 + 40 = 최소 140GiB |
USING INDEX에서 순차 읽기 후 정렬을 선택한 경우 |
위 복사본 + 테이블 크기까지의 정렬 파일 | 정렬에 최대 100GiB를 더 잡으면 240GiB |
| 작업 중 다른 트랜잭션이 데이터를 바꾸는 온라인 모드 | 동시 변경의 행 데이터 별도 저장 | 위 계산에 추가, 작업량에 따라 달라져요 |
첫 행의 140GiB는 이미 쓰는 디스크를 포함한 총량이 아니라 새로 비어 있어야 할 공간이에요. 두 번째 행도 안전한 총상한은 아니에요. 동시 변경 기록까지 모두 포함한 값으로 읽으면 안 돼요.
USING INDEX는 행을 인덱스 순서에 맞춰 다시 배치하는 선택이에요. 매뉴얼은 B-tree 인덱스를 사용할 때 인덱스를 따라 읽거나, 전체를 순차적으로 읽은 뒤 정렬하는 경로 중 비용상 유리한 쪽을 고른다고 설명해요. 정렬 파일의 추가 요구는 후자를 선택했을 때 생겨요. 단순히 공간을 회수하려는 작업인지, 행의 물리적 순서도 바꾸려는 작업인지 먼저 정하면 예산이 달라져요.
쓰기가 바쁜 테이블에는 예산이 하나 더 있어요
REPACK (CONCURRENTLY)는 작업 대부분을 다른 트랜잭션의 읽기와 쓰기를 허용하면서 진행해요. 새 파일을 만드는 동안 들어온 변경을 모아 반영하고, 마지막에 파일을 바꿀 때 강한 배타 락을 잡아요.
여기서 동시 변경은 디스크뿐 아니라 메모리도 써요. 정식 문서는 작업 도중 갱신·삭제된 행마다 필요한 일부 메모리가 maintenance_work_mem의 제한을 받지 않는다고 명시해요. 이 설정 하나를 작게 잡았다고 온라인 작업의 메모리 전체에 상한을 건 셈이 되지는 않아요.
또 REPACK은 하나의 긴 트랜잭션으로 취급돼 다른 테이블의 VACUUM이 죽은 행을 정리하는 데도 영향을 줄 수 있어요. 여유 공간을 계산할 때 대상 테이블만 보는 대신, 작업이 길어지는 동안 다른 테이블도 커질 수 있음을 고려해야 해요. 매뉴얼은 큰 테이블 작업에서 pg_stat_activity.backend_xid를 살펴보라고 권해요.
따라서 '지울 데이터가 많으니 급히 실행'하기보다, 복사본 공간과 작업 중 쓰기량을 함께 확인하는 편이 맞아요. 일상적인 정리를 맡는 VACUUM을 REPACK으로 바꾸는 용도와도 구분해야 해요.
온라인 모드는 대상과 읽기 조건도 확인해요
한국어 요약과 영어 소개에는 인덱스를 만들 수 있는 기본키가 필요하다고 나와요. 정식 매뉴얼은 온라인 모드 제외 조건을 '기본키와 인덱스 기반 replica identity가 모두 없는 테이블'이라고 적어요. replica identity는 변경된 행을 식별하기 위한 기준이에요. 기본키만이 유일한 경로라고 좁혀 읽지는 말아야 해요. 어떤 인덱스를 그 기준으로 지정할 수 있는지는 별도 조건을 확인해야 해요.
대상 제한도 있어요. UNLOGGED 테이블이나 파티션된 테이블에는 CONCURRENTLY를 사용할 수 없어요. 일반 모드와 온라인 모드의 지원 범위를 섞지 않아야 해요.
마지막 락만 기다리면 끝나는지도 살펴야 해요. 매뉴얼은 REPACK이 시작되기 전의 스냅샷, 즉 과거 상태를 기준으로 읽는 동시 트랜잭션이 REPACK 커밋 뒤 테이블을 비어 있는 것으로 볼 수 있다고 경고해요. 오래된 스냅샷을 쓰는 읽기 작업이 있는지도 점검 대상이에요.
도입 판단을 세 줄로 줄이면 이래요. 테이블과 모든 인덱스를 새로 만들 공간이 있는지, 정렬·동시 변경까지 감당할지, 온라인 모드의 대상과 읽기 조건이 앱에 맞는지예요. '2배'라는 한 숫자보다 이 항목들을 나눠 보는 쪽이 작업 시작 여부를 판단하는 데 도움이 돼요.
확인한 범위
- 기준일: 2026-11-21
- 직접 한 것: 영어 소개와 한국어 요약의 공간·기본키 조건을 PostgreSQL 19 정식 매뉴얼에 대조했어요. 테이블 100GiB와 인덱스 40GiB를 가정해 복사본 140GiB, 정렬 여유를 더 잡은 240GiB를 계산하고 동시 변경 기록은 별도로 구분했어요.
- 읽은 것: Snowflake REPACK 소개, GeekNews 요약, 정식 REPACK 매뉴얼의 자원 및 온라인 작업 조건.
- 확인하지 못한 것: 실제 공간 사용량·완료 시간·락 대기·메모리 사용은 측정하지 않았어요. replica identity 설정과 동시 작업 수의 세부 조건도 검증하지 않았어요.
출처

한국어 요약과도 비교했어요.



