출력을 작성하도록 대상 디렉토리를 설정합니다.PG_BASEBACKUP존재하지 않는 경우이 디렉토리 (및 누락 된 상위 디렉토리)를 작성합니다. 이미 존재한다면 비어 있어야합니다.

롤 토토이 TAR 형식 인 경우 대상 디렉토리를로 지정할 수 있습니다.-(Dash), TAR 파일을 작성하여stdout.

이 옵션이 필요합니다.

출력 형식을 선택합니다.형식다음 중 하나 일 수 있습니다.

a 생성and 파일 및 연결 설정을 |auto대상 디렉토리의 파일 (또는 TAR 형식을 사용할 때 기본 아카이브 파일 내). 롤 토토 결과를 사용하여 대기 서버 설정이 완화됩니다.

theauto파일은 연결 설정을 기록하며 지정된 경우 복제 슬롯PG_BASEBACKUP스트리밍 복제가 나중에 동일한 설정을 사용할 수 있도록 사용 중입니다.

서버에베이스 롤 토토을 배치 할 위치를 지시합니다. 기본 대상은입니다.클라이언트, 롤 토토이 기계로 전송되어야한다고 지정합니다.PG_BASEBACKUP가 실행 중입니다. 대상이 대신 설정되면서버 :/일부/경로, 롤 토토은 서버가 실행중인 시스템에 저장됩니다/some/path디렉토리. 서버에 롤 토토을 저장하려면 슈퍼 사용자 권한이 필요하거나의 권한이 필요합니다.pg_write_server_files역할. 대상이 설정된 경우Blackhole, 내용은 폐기되어 어디에나 저장되지 않습니다. 실제 롤 토토으로 끝나지 않기 때문에 테스트 목적으로 만 사용해야합니다.

WAL 스트리밍이 구현되었으므로PG_BASEBACKUP서버가 아닌이 옵션과 함께 사용할 수 없습니다-xstream. 기본값 이므로이 옵션이 지정되면 중 하나를 지정해야합니다.-xfetch또는-xnone.

디렉토리에서 테이블 스페이스를 재배치OlddirtoNewdir롤 토토 중. 효과적이기 위해Olddir소스 서버에 정의 된 테이블 스페이스의 경로 사양과 정확히 일치해야합니다. (그러나 테이블 스페이스가 없으면 오류가 아닙니다Olddir소스 서버에서.) 한편Newdir는 호스트 파일 시스템의 디렉토리입니다. 기본 대상 디렉토리와 마찬가지로Newdir아직 존재할 필요는 없지만 존재하는 경우 비어 있어야합니다. 둘 다OlddirandNewdir절대 경로 여야합니다. 어느 경로 중 하나가 동일한 부호를 포함 해야하는 경우 (=)는 백 슬래시로 앞에 있습니다. 이 옵션은 여러 테이블 스페이스에 대해 여러 번 지정할 수 있습니다.

이런 식으로 테이블 스페이스가 재배치되면 기본 데이터 디렉토리 내부의 상징적 링크가 새 위치를 가리 키도록 업데이트됩니다. 따라서 새로운 데이터 디렉토리는 업데이트 된 위치에 모든 테이블 스페이스가있는 새 서버 인스턴스에 사용할 준비가되었습니다.

현재이 옵션은 일반 출력 형식으로 만 작동합니다. TAR 형식이 선택되면 무시됩니다.

WAR (Write-Ahead Log) 파일을 작성하도록 디렉토리를 설정합니다. 기본적으로 WAL 파일은에 배치됩니다.PG_WAL대상 디렉토리의 하위 디렉토리이지만이 옵션을 사용하여 다른 곳에 배치 할 수 있습니다.Waldir절대 경로 여야합니다. 기본 대상 디렉토리와 마찬가지로Waldir아직 존재할 필요는 없지만 존재하는 경우 비어 있어야합니다. 이 옵션은 롤 토토이 일반 형식 일 때만 지정할 수 있습니다.

롤 토토에 필수 월 (쓰기 로그) 파일이 포함되어 있습니다. 여기에는 롤 토토 중에 생성 된 모든 쓰기 로그가 포함됩니다.없음지정되어 있습니다. WAL 아카이브를 참조 할 필요없이 대상 디렉토리에서 우체국을 시작할 수 있으므로 출력이 완전히 독립형 롤 토토을 만들 수 있습니다..

다음메소드쓰기 로그를 수집하려면 지원됩니다.

기본 압축 레벨과 함께 TAR 파일 출력의 GZIP 압축을 활성화합니다. 압축은 TAR 형식을 사용할 때만 사용할 수 있으며 접미사.gz모든 타르 파일 이름에 자동으로 추가됩니다.

롤 토토의 압축을 요청합니다. 만약에클라이언트또는Server포함되어 있으며 압축을 수행 할 위치를 지정합니다. 서버에서 압축하면 전송 대역폭이 줄어들지 만 서버 CPU 소비가 증가합니다.클라이언트제외-타겟사용됩니다. 이 경우 롤 토토이 클라이언트로 전송되지 않으므로 서버 압축 만 합리적입니다.-xstream22996_23145-xfetch.

압축 방법을 설정할 수 있습니다gzip, LZ4, ZSTD, 없음압축 또는 정수 없음 (0, 0 인 경우 압축 없음gzip0보다 큰 경우). 압축 세부 사항 문자열을 선택적으로 지정할 수 있습니다.키워드또는키워드 = value. 현재 지원되는 키워드는입니다.레벨, Long및노동자. 압축 방법이 일반 정수로 지정 될 때 세부 문자열을 사용할 수 없습니다.

압축 레벨이 지정되지 않으면 기본 압축 레벨이 사용됩니다. 알고리즘을 언급하지 않고 레벨 만 지정된 경우gzip레벨이 0보다 큰 경우 압축이 사용되며 레벨이 0 인 경우 압축이 사용되지 않습니다.

TAR 형식을 사용하는 경우gzip, LZ4또는ZSTD, 접미사.gz, .LZ4또는.zst는 각각 모든 TAR 파일 이름에 자동으로 추가됩니다. 일반 형식을 사용하면 클라이언트 측 압축이 지정되지 않을 수 있지만 서버 측 압축을 요청할 수 있습니다.

이 옵션이와 함께 사용되는 경우-xstream, PG_WAL사용을 사용하여 압축됩니다gzip클라이언트 측 GZIP 압축이 선택되지만 다른 압축 알고리즘이 선택되거나 서버 측 압축이 선택된 경우 압축되지 않습니다.

체크 포인트 모드를 빠른 (즉시) 또는 스프레드 (기본값)로 설정합니다 (참조섹션 26.3.3).

|-슬롯롤 토토을 시작하기 전에 옵션을 작성해야합니다. 슬롯이 이미 존재하면 오류가 발생합니다.

롤 토토에 대한 레이블을 설정합니다. 아무것도 지정되지 않으면의 기본값은“PG_BASEBACKUP베이스 롤 토토”사용됩니다.

기본적으로PG_BASEBACKUP오류가 발생하여 작업을 완료 할 수 없음을 발견하기 전에 생성 한 디렉토리를 제거합니다 (예 : 대상 디렉토리 및 쓰기 로그 디렉토리). 이 옵션은 정리를 억제하므로 디버깅에 유용합니다.

테이블 스페이스 디렉토리가 어느 쪽이든 정리되지 않음에 유의하십시오.

기본적으로PG_BASEBACKUP모든 파일이 디스크에 안전하게 작성되기를 기다립니다. 이 옵션은PG_BASEBACKUP대기하지 않고 돌아 오기 위해 더 빠르지 만 후속 운영 체제 충돌로 기본 롤 토토이 손상 될 수 있음을 의미합니다. 일반적 으로이 옵션은 테스트에 유용하지만 생산 설치를 만들 때 사용해서는 안됩니다.

진행 상황보고를 활성화합니다. 이것을 켜면 롤 토토 중에 대략적인 진행률 보고서가 제공됩니다.100%. 특히 WAL Log가 롤 토토에 포함되면 총 데이터 양은 미리 추정 할 수 없으며이 경우 WAL없이 총 견적을 통과하면 추정 목표 크기가 증가합니다..

소스 서버에서 데이터가 수집되는 최대 전송 속도를 설정합니다. 이것은의 영향을 제한하는 데 유용 할 수 있습니다PG_BASEBACKUP서버에서. 값은 초당 킬로바이트입니다.M초당 메가 바이트를 나타냅니다. 의 접미사k도 받아 들여지고 영향을 미치지 않습니다. 유효한 값은 초당 32 킬로바이트와 초당 1024 메가 바이트 사이입니다.

이 옵션은 항상 데이터 디렉토리의 전송에 영향을 미칩니다. WAL 파일의 전송은 수집 방법이 인 경우에만 영향을받습니다.Fetch.

이 옵션은와 함께 만 사용할 수 있습니다.-x stream. WAL 스트리밍이 지정된 복제 슬롯을 사용하게됩니다.Primary_Slot_name. 이를 통해 기본 서버가 기본 롤 토토 종료 시간과 새 대기에서 스트리밍 복제 시작 사이에 필요한 WAL 데이터를 제거하지 않도록합니다..

옵션이 아니라면 지정된 복제 슬롯이 존재해야합니다-c도 사용됩니다.

이 옵션이 지정되지 않고 서버가 임시 복제 슬롯 (버전 10 이상)을 지원하면 임시 복제 슬롯이 WAL 스트리밍에 자동으로 사용됩니다.

Verbose 모드를 활성화합니다. 스타트 업 및 종료 중에 추가 단계를 출력 할뿐만 아니라 현재 처리가 활성화 된 경우 현재 처리중인 정확한 파일 이름을 표시합니다.

롤 토토 매니페스트에 포함 된 각 파일에 적용 해야하는 체크섬 알고리즘을 지정합니다. 현재 사용 가능한 알고리즘은입니다.없음, CRC32C, SHA224, SHA256, SHA384및SHA512. 기본값은CRC32C.

if없음선택되어 롤 토토 매니페스트에는 체크섬이 포함되어 있지 않습니다. 그렇지 않으면 지정된 알고리즘을 사용하여 롤 토토에 각 파일의 체크섬이 포함됩니다.SHA256자체 내용 체크섬. 그만큼sha알고리즘은보다 CPU 집약적입니다.CRC32C, 그 중 하나를 선택하면 롤 토토을 완료하는 데 필요한 시간이 증가 할 수 있습니다.

SHA HASH 함수 사용은 롤 토토이 변조되지 않았는지 확인하려는 사용자를 위해 각 파일의 암호적으로 안전한 소화를 제공하지만 CRC32C 알고리즘은 계산하기가 훨씬 빠른 체크섬을 제공합니다. 우발적 인 변경으로 인해 오류를 잡는 데 능숙하지만 악의적 인 수정에 저항하지 않습니다.

pg_verifybackup롤 토토 매니페스트에 대한 롤 토토의 무결성을 확인하는 데 사용할 수 있습니다.

롤 토토의 모든 파일 이름이 16 진수로 인코딩되도록 강제합니다. 이 옵션이 지정되지 않은 경우 비 utf8 파일 이름 만 16 진수로 인코딩됩니다.

서버가 스트리밍 될 총 롤 토토 데이터의 총량을 추정하지 못하면backup_total열의 열PG_STAT_PROGRESS_BASEBACKUP항상보기null.

이 옵션이 없으면 롤 토토은 전체 데이터베이스의 크기를 열거하여 시작하여 실제 컨텐츠를 보내십시오. 이로 인해 롤 토토이 약간 더 오래 걸릴 수 있으며, 특히 첫 번째 데이터가 전송되기까지 더 오래 걸립니다.

사용시이 옵션이 허용되지 않습니다-프로그램.

롤 토토 매니페스트 생성을 비활성화합니다. 이 옵션이 지정되지 않은 경우 서버는 생성 및 롤 토토 매니페스트를 보냅니다.pg_verifybackup. 매니페스트는 포함될 수있는 WAL 파일을 제외하고 롤 토토에있는 모든 파일 목록입니다.

롤 토토을위한 임시 복제 슬롯의 생성을 방지합니다.

기본적으로 로그 스트리밍이 선택되었지만 슬롯 이름이없는 경우-s옵션, 임시 복제 슬롯이 생성됩니다 (소스 서버에서 지원하는 경우)

이 옵션의 주요 목적은 서버에 무료 복제 슬롯이 없을 때베이스 롤 토토을 수행하는 것입니다. 복제 슬롯 사용은 거의 항상 선호됩니다. 롤 토토 중에 필요한 WAL이 서버에서 제거되는 것을 방지하기 때문입니다.

서버에서 활성화되면 기본 롤 토토이 가져옵니다..

기본적으로 체크섬이 확인되고 체크섬 고장으로 인해 0이 아닌 출구 상태가 발생합니다. 그러나 마치 마치 마치 마치 인 경우 기본 롤 토토이 제거되지 않습니다.-no-clean옵션이 사용되었습니다. 체크섬 검증 실패는 또한 에보 고됩니다.PG_STAT_DATABASE보기

서버에 연결하는 데 사용되는 매개 변수를 지정합니다.연결 문자열; 충돌하는 명령 줄 옵션을 무시합니다.

옵션은입니다.-dbname다른 클라이언트 애플리케이션과의 일관성이 있지만PG_BASEBACKUP클러스터의 특정 데이터베이스에 연결하지 않으면 연결 문자열의 데이터베이스 이름이 무시됩니다.

서버가 실행중인 시스템의 호스트 이름을 지정합니다. 값이 슬래시로 시작하면 Unix 도메인 소켓의 디렉토리로 사용됩니다.pghost환경 변수, 설정하면 UNIX 도메인 소켓 연결이 시도됩니다.

서버가 연결을 듣고있는 TCP 포트 또는 로컬 UNIX 도메인 소켓 파일 확장을 지정합니다. 기본값pgport환경 변수, 설정된 경우 또는 컴파일 된 기본값

소스 서버로 다시 전송 된 상태 패킷 사이의 초 수를 지정합니다. 더 작은 값을 사용하면 서버에서 롤 토토 진행을보다 정확하게 모니터링 할 수 있습니다.

연결할 사용자 이름을 지정합니다.

비밀번호 프롬프트 발급을 방지합니다. 서버에 비밀번호 인증이 필요하고 A와 같은 다른 방법으로 암호를 사용할 수없는 경우.pgpass파일, 연결 시도가 실패합니다. 이 옵션은 비밀번호를 입력 할 사용자가없는 배치 작업 및 스크립트에 유용 할 수 있습니다.

ForcesPG_BASEBACKUP소스 서버에 연결하기 전에 비밀번호를 신속하게하려면

이 옵션은 결코 필수적이지 않습니다.PG_BASEBACKUP서버가 암호 인증을 요구하는 경우 비밀번호를 자동으로 프롬프트합니다. 하지만,PG_BASEBACKUP서버가 비밀번호를 원한다는 것을 알아내는 연결 시도를 낭비합니다. 어떤 경우에는 입력 할 가치가 있습니다-w추가 연결 시도를 피하려면

인쇄PG_BASEBACKUP버전 및 종료.

도움말 표시PG_BASEBACKUP명령 줄 인수 및 종료.