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

젠 토토이 tar 형식인 경우 대상 디렉터리는 다음과 같이 지정될 수 있습니다.-(대시), tar 파일이 기록되도록 함stdout.

이 옵션은 필수입니다.

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

생성대기.신호 파일을 작성하고 연결 설정을 에 추가합니다.postgresql.auto.conf파일을 대상 디렉토리(또는 tar 형식을 사용하는 경우 기본 아카이브 파일 내)에 저장합니다. 이렇게 하면 젠 토토 결과를 사용하여 대기 서버를 쉽게 설정할 수 있습니다.

그postgresql.auto.conf파일은 연결 설정을 기록하고 지정된 경우 복제 슬롯을 기록합니다.pg_basebackup사용 중이므로 스트리밍 복제는 나중에 동일한 설정을 사용합니다.

디렉토리에서 테이블스페이스를 재배치olddir에newdir젠 토토 중. 효과적이려면,olddir소스 서버에 정의된 테이블스페이스의 경로 사양과 정확히 일치해야 합니다. (단, 테이블스페이스가 없으면 에러가 아니다.)olddir소스 서버에서.) 한편newdir은 수신 호스트 파일 시스템의 디렉터리입니다. 기본 대상 디렉터리와 마찬가지로,newdir이미 존재할 필요는 없지만 존재하는 경우 비어 있어야 합니다. 둘 다olddir그리고newdir절대 경로여야 합니다. 두 경로 중 하나에 등호()가 포함되어야 하는 경우=) 앞에 백슬래시를 추가하세요. 이 옵션은 여러 테이블스페이스에 대해 여러 번 지정할 수 있습니다.

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

현재 이 옵션은 일반 출력 형식에서만 작동합니다. tar 형식을 선택하면 무시됩니다.

WAL(미리 쓰기 로그) 파일을 쓸 디렉토리를 설정합니다. 기본적으로 WAL 파일은pg_wal대상 디렉토리의 하위 디렉토리이지만 이 옵션을 사용하여 다른 곳에 배치할 수 있습니다.왈디르반드시 경로여야 합니다. 기본 대상 디렉터리와 마찬가지로,왈디르이미 존재할 필요는 없지만 존재하는 경우 비어 있어야 합니다. 이 옵션은 젠 토토이 일반 형식인 경우에만 지정할 수 있습니다.

젠 토토에 필수 WAL(미리 쓰기 로그) 파일을 포함합니다. 여기에는 젠 토토 중에 생성된 모든 미리 쓰기 로그가 포함됩니다. 방법이 아니라면없음이 지정되면 로그 아카이브를 참조할 필요 없이 대상 디렉터리에서 포스트마스터를 시작할 수 있으므로 출력을 완전히 독립형 젠 토토으로 만들 수 있습니다.

다음방법20883_20937

기본 압축 수준으로 tar 파일 출력의 gzip 압축을 활성화합니다. 압축은 tar 형식과 접미사를 사용하는 경우에만 가능합니다..gz모든 tar 파일 이름에 자동으로 추가됩니다.

tar 파일 출력의 gzip 압축을 활성화하고 압축 수준을 지정합니다(0~9, 0은 압축되지 않음, 9는 최고 압축). 압축은 tar 형식과 접미사를 사용하는 경우에만 가능합니다..gz모든 tar 파일 이름에 자동으로 추가됩니다.

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

다음에 의해 명명된 복제 슬롯을 지정합니다.--슬롯옵션은 젠 토토을 시작하기 전에 생성되어야 합니다. 슬롯이 이미 존재하면 오류가 발생합니다.

젠 토토 라벨을 설정합니다. 아무것도 지정하지 않으면 기본값은“pg_basebackup 기본 젠 토토”사용됩니다.

기본적으로 언제pg_basebackup오류와 함께 중단되면 작업을 완료할 수 없다는 사실을 발견하기 전에 생성했을 수 있는 모든 디렉터리(예: 대상 디렉터리 및 미리 쓰기 로그 디렉터리)를 제거합니다. 이 옵션은 정리를 금지하므로 디버깅에 유용합니다.

테이블스페이스 디렉토리는 어떤 방법으로도 정리되지 않는다는 점에 유의하세요.

기본적으로,pg_basebackup모든 파일이 디스크에 안전하게 기록될 때까지 기다립니다. 이 옵션으로 인해pg_basebackup기다리지 않고 반환하는 것이 더 빠르지만 후속 운영 체제 충돌로 인해 기본 젠 토토이 손상될 수 있음을 의미합니다. 일반적으로 이 옵션은 테스트에 유용하지만 프로덕션 설치를 생성할 때는 사용하면 안 됩니다.

진행상황 보고를 활성화합니다. 이 기능을 켜면 젠 토토 중에 대략적인 진행 보고서가 제공됩니다. 젠 토토 중에 데이터베이스가 변경될 수 있으므로 이는 대략적인 것일 뿐이며 정확하게 끝나지 않을 수 있습니다.100%. 특히 젠 토토에 WAL 로그가 포함된 경우 전체 데이터 양을 미리 예측할 수 없으며, 이 경우 WAL 없이 전체 예측을 통과하면 예상 대상 크기가 증가합니다.

소스 서버에서 데이터가 수집되는 최대 전송 속도를 설정합니다. 이는 다음의 영향을 제한하는 데 유용할 수 있습니다.pg_basebackup서버에서. 값은 초당 킬로바이트 단위입니다. 의 접미사를 사용하세요.M초당 메가바이트를 나타냅니다. 의 접미사k또한 허용되며 아무런 효과가 없습니다. 유효한 값은 초당 32KB에서 1024MB 사이입니다.

이 옵션은 항상 데이터 디렉토리 전송에 영향을 미칩니다. WAL 파일 전송은 수집 방법이 다음과 같은 경우에만 영향을 받습니다.가져오기.

이 옵션은 다음과 함께만 사용할 수 있습니다.-X 스트림. WAL 스트리밍이 지정된 복제 슬롯을 사용하게 됩니다. 기본 젠 토토을 복제 슬롯을 사용하여 스트리밍 복제 대기로 사용하려는 경우 대기는 다음과 동일한 복제 슬롯 이름을 사용해야 합니다.primary_slot_name. 이렇게 하면 기본 서버가 기본 젠 토토 종료와 새 대기 서버에서 스트리밍 복제 시작 사이의 시간에 필요한 WAL 데이터를 제거하지 않도록 보장됩니다.

옵션이 아닌 이상 지정된 복제 슬롯이 존재해야 합니다.-C또한 사용됩니다.

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

상세 모드를 활성화합니다. 시작 및 종료 중에 몇 가지 추가 단계를 출력할 뿐만 아니라 진행률 보고가 활성화된 경우 현재 처리 중인 정확한 파일 이름도 표시합니다.

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

만약없음을 선택하면 젠 토토 매니페스트에 체크섬이 포함되지 않습니다. 그렇지 않으면 지정된 알고리즘을 사용하여 젠 토토에 있는 각 파일의 체크섬이 포함됩니다. 또한 매니페스트에는 항상SHA256자체 내용의 체크섬입니다.샤알고리즘은 다음보다 훨씬 더 CPU 집약적입니다.CRC32C, 따라서 그 중 하나를 선택하면 젠 토토을 완료하는 데 필요한 시간이 늘어날 수 있습니다.

SHA 해시 기능을 사용하면 젠 토토이 변조되지 않았는지 확인하려는 사용자에게 암호화된 보안 다이제스트가 제공되며, CRC32C 알고리즘은 계산 속도가 훨씬 빠른 체크섬을 제공합니다. 실수로 인한 변경으로 인한 오류를 잡는 데는 좋지만 악의적인 수정에는 저항력이 없습니다. 젠 토토에 액세스할 수 있는 적에게 유용하려면 젠 토토 매니페스트를 다른 곳에 안전하게 저장하거나 젠 토토이 수행된 이후 수정되지 않았는지 확인해야 합니다.

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

젠 토토 매니페스트의 모든 파일 이름을 16진수로 인코딩하도록 강제합니다. 이 옵션을 지정하지 않으면 UTF8이 아닌 파일 이름만 16진수로 인코딩됩니다. 이 옵션은 주로 젠 토토 매니페스트 파일을 읽는 도구가 이 사례를 올바르게 처리하는지 테스트하기 위한 것입니다.

서버가 스트리밍될 젠 토토 데이터의 총량을 예측하는 것을 방지하여 결과는 다음과 같습니다.backup_total열의pg_stat_progress_basebackup항상 존재하는 모습NULL.

이 옵션이 없으면 전체 데이터베이스의 크기를 열거하여 젠 토토을 시작한 다음 돌아가서 실제 내용을 보냅니다. 이로 인해 젠 토토 시간이 약간 더 길어질 수 있으며, 특히 첫 번째 데이터가 전송되기 전에 시간이 더 오래 걸릴 수 있습니다. 이 옵션은 추정 시간이 너무 긴 경우 이러한 추정 시간을 방지하는 데 유용합니다.

이 옵션은 사용할 때 허용되지 않습니다.--진행.

젠 토토 매니페스트 생성을 비활성화합니다. 이 옵션을 지정하지 않으면 서버는 다음을 사용하여 확인할 수 있는 젠 토토 매니페스트를 생성하고 보냅니다.pg_verifybackup. 매니페스트는 포함될 수 있는 WAL 파일을 제외하고 젠 토토에 있는 모든 파일의 목록입니다. 또한 각 파일의 크기, 마지막 수정 시간, 선택적 체크섬도 저장합니다.

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

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

이 옵션의 주요 목적은 서버에 여유 복제 슬롯이 없을 때 기본 젠 토토을 허용하는 것입니다. 복제 슬롯을 사용하는 것은 젠 토토 중에 필요한 WAL이 서버에 의해 제거되는 것을 방지하기 때문에 거의 항상 선호됩니다.

기본 젠 토토을 가져온 서버에서 체크섬이 활성화된 경우 체크섬 확인을 비활성화합니다.

기본적으로 체크섬은 확인되며 체크섬에 실패하면 0이 아닌 종료 상태가 됩니다. 그러나 다음과 같은 경우에는 기본 젠 토토이 제거되지 않습니다.--청소 없음옵션이 사용되었습니다. 체크섬 확인 실패도 다음 페이지에 보고됩니다.pg_stat_database보기.

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

옵션이 호출되었습니다.--dbname다른 클라이언트 응용 프로그램과의 일관성을 위해, 그러나 그 이유는pg_basebackup클러스터의 특정 데이터베이스에 연결하지 않으며 연결 문자열의 데이터베이스 이름은 무시됩니다.

서버가 실행 중인 시스템의 호스트 이름을 지정합니다. 값이 슬래시로 시작하면 Unix 도메인 소켓의 디렉터리로 사용됩니다. 기본값은에서 가져옵니다.PGHOST환경 변수, 설정된 경우 그렇지 않으면 Unix 도메인 소켓 연결이 시도됩니다.

서버가 연결을 수신하고 있는 TCP 포트 또는 로컬 Unix 도메인 소켓 파일 확장자를 지정합니다. 기본값은PG포트환경 변수(설정된 경우) 또는 컴파일된 기본값.

소스 서버로 다시 전송되는 상태 패킷 사이의 시간(초)을 지정합니다. 값이 작을수록 서버에서 젠 토토 진행 상황을 더 정확하게 모니터링할 수 있습니다. 값이 0이면 주기적인 상태 업데이트가 완전히 비활성화됩니다. 단, 시간 초과로 인한 연결 끊김을 방지하기 위해 서버에서 요청할 때 업데이트가 계속 전송됩니다. 기본값은 10초입니다.

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

비밀번호 프롬프트 발행을 방지합니다. 서버가 비밀번호 인증을 요구하는데 다음과 같은 다른 방법으로 비밀번호를 사용할 수 없는 경우.pgpass파일을 사용하면 연결 시도가 실패합니다. 이 옵션은 비밀번호를 입력할 사용자가 없는 일괄 작업 및 스크립트에 유용할 수 있습니다.

부대pg_basebackup소스 서버에 연결하기 전에 비밀번호를 묻는 메시지를 표시합니다.

이 옵션은 결코 필수가 아닙니다. 왜냐하면pg_basebackup서버가 비밀번호 인증을 요구하면 자동으로 비밀번호를 묻는 메시지를 표시합니다. 그러나pg_basebackup서버가 비밀번호를 원하는지 알아내는 연결 시도를 낭비하게 됩니다. 어떤 경우에는 입력할 가치가 있습니다.-W추가 연결 시도를 피하기 위해.

다음을 인쇄합니다pg_basebackup버전 및 종료.

다음에 대한 도움말 표시pg_basebackup명령줄 인수 및 종료.