pg_partman으로 PostgreSQL 파티셔닝 자동화

소개: 왜 pg_partman을 쓰는가

대용량 테이블을 다루다 보면 파티셔닝은 필수적이다. 수동으로 파티션을 관리하면 운영 부담과 오류 가능성이 커진다. pg_partman은 파티셔닝 생성과 유지보수를 자동화해 운영 시간을 절약하고 쿼리 성능을 안정화한다. 이 글은 pg_partman 설정 postgres, postgres 파티셔닝 자동화, pg_partman 튜토리얼 같은 키워드를 자연스럽게 설명한다.

기본 개념 정리

파티셔닝 방식

주로 사용하는 방식은 시간 기반(range)과 키 기반(hash) 파티셔닝이다. 시간 기반은 로그나 시계열 데이터에 적합하고, 키 기반은 균등 분산이 필요한 경우 유리하다. pg_partman은 두 방식 모두 지원하며, 자동 생성 전략을 선택할 수 있다.

pg_partman의 역할

pg_partman은 다음 기능을 제공한다.

• 파티션 테이블 및 서브파티션 자동 생성
• 파티션 유지보수(아카이브, 삭제) 스케줄링
• 자동 인덱스 생성과 통계 유지 보조

설치 및 초기 설정

pg_partman은 확장(extension) 형태로 제공된다. PostgreSQL 서버에 설치 후 확장을 생성하면 된다. 운영 환경에선 패키지 매니저로 설치하거나 소스 빌드 후 확장을 생성한다.

설치 예시 (Ubuntu apt 기반)

sudo apt-get update
sudo apt-get install postgresql-13-partman

데이터베이스에서 확장 생성

-- 확장 생성 (데이터베이스 연결 후)
CREATE EXTENSION IF NOT EXISTS pg_partman;
-- 파티셔닝 메타스키마 생성
CREATE SCHEMA IF NOT EXISTS partman;

파티션 세트 만들기

파티션을 적용하려는 테이블이 준비되어 있다면 파티셔닝 규칙을 정의해 파티션 세트를 만든다. 아래 예시는 시간 기반(range) 파티셔닝을 설정하는 절차다.

예제: 시간 기반 파티셔닝 적용

-- 예시 테이블
CREATE TABLE logs (
  id serial PRIMARY KEY,
  log_time timestamptz NOT NULL,
  level text,
  message text
);

-- 파티션 세트 생성 (daily 기준)
SELECT partman.create_parent('public.logs', 'log_time', 'partman', 'daily');

위 명령은 public.logs를 기준으로 일별 파티션을 생성하고 관리하도록 설정한다. 파티션 네이밍, 보존 정책 등 옵션을 추가로 지정할 수 있다.

자동화와 유지보수

자동 작업 설정

pg_partman은 자체 유지보수 함수를 제공한다. 정기적으로 호출해 새로운 파티션 생성이나 오래된 파티션 삭제를 수행한다. 가장 간단한 방법은 cron이나 PostgreSQL의 pg_cron, 혹은 운영중인 스케줄러에서 호출하는 것이다.

예시: 유지보수 함수 호출

-- 파티션 자동 생성 및 정리 실행
SELECT partman.run_maintenance('public.logs');

운영에서는 이 호출을 1시간 또는 일 단위로 스케줄링한다. 생성 정책(create_more_than)과 보존 기간(retention) 등의 설정을 통해 디스크 사용량과 성능 목표를 맞출 수 있다.

모니터링과 문제 해결

모니터링 포인트

• 파티션 수와 최근 생성 시각
• 디스크 사용량 및 오래된 파티션 보존 여부
• 자동 유지보수 실패 로그

로그와 권한 문제

자동작업이 실패하는 일반적 원인은 권한 부족과 잠금 충돌이다. pg_partman은 파티션 생성 시 테이블 잠금을 사용하므로 유지보수 시간에는 쓰기 부하를 고려해 스케줄을 조정해야 한다. 권한은 확장과 관련 함수 실행을 위한 적절한 데이터베이스 권한을 확인한다.

베스트 프랙티스

• 테스트 환경에서 먼저 파티셔닝 정책을 검증한다.
• 보존 정책(retention)은 비즈니스 요구와 비용을 고려해 설정한다.
• 유지보수 주기는 데이터 생성량을 기준으로 정한다.
• 인덱스와 통계 업데이트 주기를 함께 관리해 쿼리 플랜 변화를 최소화한다.

마무리: 적용 체크리스트

• pg_partman 설치 및 확장 생성 여부 확인
• 파티셔닝 기준 컬럼과 방식 결정
• 파티션 생성 정책과 보존 정책 설정
• 유지보수 스케줄링 및 모니터링 적용

pg_partman 설정 postgres 관련 절차를 따르면 파티셔닝 자동화가 가능하다. postgres 파티셔닝 자동화의 핵심은 정책 설계와 주기적 유지보수이며, pg_partman 튜토리얼을 통해 차근차근 적용하면 운영 안정성과 성능을 동시에 개선할 수 있다.