본문으로 건너뛰기

summarize_wal

버전기본값context타입
17offsighupboolean
18offsighupboolean
19offsighupboolean

WAL summarizer process를 활성화한다. 기본값은 off이며 postgresql.conf나 서버 커맨드라인에서만 설정할 수 있다.

PostgreSQL 17에서 incremental backup과 함께 도입된 파라미터다. summarizer는 WAL을 읽어 어떤 릴레이션의 어떤 블록이 변경됐는지 요약한 summary 파일을 만들고, pg_basebackup --incremental은 이 summary를 근거로 이전 backup 이후 변경된 블록만 복사한다. primary와 standby 어느 쪽에서든 켤 수 있다.

wal_levelminimal이면 summarize_wal=on으로 서버를 시작할 수 없다. 서버 기동 후 wal_level=minimal 상태에서 이 값을 켜면 summarizer는 실행되지만, minimal로 생성된 WAL에 대해서는 summary 파일 생성을 거부한다.

운영 노트: incremental backup을 도입하려면 먼저 이 파라미터를 켜야 한다. summary 파일 보존 기간은 wal_summary_keep_time으로 조절하며, backup 간격보다 넉넉히 잡아야 incremental backup이 실패하지 않는다.

출처: PostgreSQL 18 문서