물리 복제본 구축(pg_basebackup)

명령어

pg_basebackup -h primary_host -U replicator -D /var/lib/postgresql/16/main -Fp -Xs -P -R --slot=replica_slot_1 -C

하는 일

primary에서 전체 물리 백업을 수행하고, WAL을 스트리밍하며(-Xs), standby.signal과 primary_conninfo를 기록하고(-R), replication slot을 생성한다(-C).

사용 시점

새 streaming standby(읽기 복제본 또는 페일오버 대상)를 구축하기 위해.

주의

대상 디렉터리(-D)는 비어 있어야 한다. primary의 pg_hba.conf가 replicator 사용자에게 'replication' 접근을 허용해야 하며, 충분한 wal_keep_size / slot이 있어야 한다. PostgreSQL 12+에서 -R은 recovery.conf 대신 standby.signal을 생성한다.