PG_BASEBACKUP - a의 기본 배트맨 토토을 받으십시오.PostgreSQL클러스터
PG_BASEBACKUP[옵션...]
PG_BASEBACKUP달리기의 기본 배트맨 토토을 수행하는 데 사용됩니다PostgreSQL데이터베이스 클러스터. 이들은 다른 클라이언트에 데이터베이스에 영향을 미치지 않고 취해졌으며 시점 복구에 모두 사용할 수 있습니다 (참조젠 토토 PostgreSQL : 문서 : 11 : 25.3. 연속 보관 및 시점 복구 (PITR)) 및 로그 배송 또는 스트리밍 복제 대기 서버의 시작점 (참조PostgreSQL : 문서 : 11 : 26.2. 로그쉽 토토 캔 서버).
PG_BASEBACKUP데이터베이스 클러스터 파일의 이진 사본을 만들고 시스템이 배트맨 토토 모드를 자동으로 입력하고 나가도록합니다. 배트맨 토토은 항상 전체 데이터베이스 클러스터에서 가져옵니다. 개별 데이터베이스 또는 데이터베이스 개체를 배트맨 토토 할 수 없습니다. 개별 데이터베이스 배트맨 토토의 경우와 같은 도구pg_dump사용해야합니다.
배트맨 토토은 정기적으로 이루어집니다postgresql연결 및 복제 프로토콜을 사용합니다. 슈퍼업자 또는 사용자와 연결해야합니다.복제권한 (참조PostgreSQL : 문서 : 11 : 21.2. 사설 토토 사이트 속성) 및pg_hba.conf복제 연결을 명시 적으로 허용해야합니다. 서버도로 구성해야합니다.max_wal_senders배트맨 토토에 적어도 하나의 세션을 남겨두고 WAL 스트리밍을 위해 하나 이상의 세션을 남겨두기에 충분히 높은 설정 (
여러 가지가있을 수 있습니다PG_BASEBACKUPs는 동시에 실행되지만 성능 관점에서 하나의 배트맨 토토 만 가져 와서 결과를 복사하는 것이 좋습니다..
pg_basebackup마스터뿐만 아니라 대기에서도베이스 배트맨 토토을 만들 수 있습니다. 대기에서 배트맨 토토을 가져 오려면 대기를 설정하여 복제 연결을 수락 할 수 있도록 대기를 설정하십시오 (즉, SETmax_wal_sendersandhot_standby및 구성스포츠 토토 PostgreSQL : 문서 : 11 : 20.1. pg_hba.conf 파일). 또한 활성화해야합니다full_page_writes마스터.
대기에서 온라인 배트맨 토토에 몇 가지 제한 사항이 있습니다.
배트맨 토토 기록 파일은 데이터베이스 클러스터에 생성되지 않았습니다.
pg_basebackup대기는 배트맨 토토 끝에서 새 WAL 파일로 전환하도록 강요 할 수 없습니다. 당신이 사용할 때-x none, 기본의 쓰기 활동이 낮 으면PG_BASEBACKUP배트맨 토토이 전환 및 보관되기 위해 필요한 마지막 WAL 파일을 오랫동안 기다려야 할 수도 있습니다. 이 경우 실행하는 것이 유용 할 수 있습니다PG_SWITCH_WAL즉시 WAL 파일 스위치를 트리거하기 위해 기본의 경우
온라인 배트맨 토토 중에 대기가 마스터로 홍보되면 배트맨 토토이 실패합니다.
배트맨 토토에 필요한 모든 WAL 레코드는 충분한 전체 페이지 쓰기를 포함해야하므로 활성화해야합니다full_page_writes마스터에서와 같은 도구를 사용하지 마십시오pg_compresslogasarchive_commandWAL 파일에서 전체 페이지를 제거하려면
다음 명령 줄 옵션은 출력의 위치와 형식을 제어합니다.
-d디렉토리--pgdata =디렉토리출력을 작성하는 디렉토리.PG_BASEBACKUP필요한 경우 디렉토리 및 부모 디렉토리를 작성합니다. 디렉토리는 이미 존재할 수 있지만 디렉토리가 이미 존재하고 비어 있지 않으면 오류입니다.
배트맨 토토이 TAR 모드에 있고 디렉토리가로 지정됩니다.-(Dash), TAR 파일은에 기록됩니다.stdout.
이 옵션이 필요합니다.
-f형식-format =형식출력 형식을 선택합니다.형식다음 중 하나 일 수 있습니다.
P일반현재 데이터 디렉토리 및 테이블 스페이스와 동일한 레이아웃을 사용하여 출력을 일반 파일로 작성하십시오. 클러스터에 추가 테이블 스페이스가 없으면 전체 데이터베이스가 대상 디렉토리에 배치됩니다. 클러스터에 추가 테이블 스페이스가 포함 된 경우 기본 데이터 디렉토리가 대상 디렉토리에 배치되지만 다른 모든 테이블 스페이스는 소스 서버와 동일한 절대 경로에 배치됩니다. (보다--- 테이블 스페이스 맵핑변경하려면)
이것은 기본 형식입니다.
t타르대상 디렉토리에서 출력을 TAR 파일로 작성합니다. 기본 데이터 디렉토리는이라는 파일에 기록됩니다.base.tar, 그리고 다른 모든 테이블 스페이스는 테이블 스페이스 OID의 이름을 따서 명명됩니다.
값인 경우-(DASH)는 대상 디렉토리로 지정되어 있으며 TAR 컨텐츠는 표준 출력에 기록되어 배관에 적합합니다.gzip. 클러스터에 추가 테이블 스페이스가없고 WAL 스트리밍이 사용되지 않는 경우에만 가능합니다.
-rrate--max-rate =rate서버에서 전송 된 데이터의 최대 전송 속도. 값은 초당 킬로바이트입니다. 의 접미사 사용M초당 메가 바이트를 나타냅니다. 의 접미사K도 받아 들여지고 영향을 미치지 않습니다. 유효한 값은 초당 32 킬로바이트와 초당 1024 메가 바이트 사이입니다.
목적은의 영향을 제한하는 것입니다.PG_BASEBACKUP실행중인 서버에서.
이 옵션은 항상 데이터 디렉토리의 전송에 영향을 미칩니다. WAL 파일의 전송은 수집 방법이 인 경우에만 영향을받습니다.fetch.
-r-write-recovery-conf최소한 쓰기복구 .conf대기 서버를 쉽게 설정하기 위해 출력 디렉토리 (또는 TAR 형식을 사용할 때 기본 아카이브 파일)에서. 그만큼복구 .conf파일은 연결 설정을 기록하며 지정된 경우 복제 슬롯PG_BASEBACKUP스트리밍 복제가 나중에 동일한 설정을 사용하도록 사용 중입니다.
-tOlddir=Newdir--- 테이블 스페이스 맵핑 =Olddir=Newdir디렉토리에서 테이블 스페이스 재배치OlddirtoNewdir배트맨 토토 중. 효과적이기 위해Olddir현재 정의 된 테이블 스페이스의 경로 사양과 정확히 일치해야합니다. (그러나 테이블 스페이스가 없으면 오류가 아닙니다Olddir배트맨 토토에 포함되어 있습니다.) 둘 다OlddirandNewdir절대 경로 여야합니다. 경로에 A가 포함 된 경우=서명, 백 슬래시로 탈출하십시오. 이 옵션은 여러 테이블 스페이스에 대해 여러 번 지정할 수 있습니다. 아래 예를 참조하십시오.
테이블 스페이스가 이러한 방식으로 재배치되면 기본 데이터 디렉토리 내부의 상징적 링크가 새 위치를 가리 키도록 업데이트됩니다. 따라서 새로운 데이터 디렉토리는 업데이트 된 위치에 모든 테이블 스페이스가있는 새 서버 인스턴스에 사용할 준비가되었습니다.
현재이 옵션은 일반 출력 형식으로 만 작동합니다. TAR 형식이 선택되면 무시됩니다.
--waldir =Waldir쓰기 로그 디렉토리의 위치를 지정합니다.Waldir절대적인 경로 여야합니다. 쓰기 로그 디렉토리는 배트맨 토토이 일반 모드 일 때만 지정할 수 있습니다.
-xMethod-wal-method =Method배트맨 토토에 필수 쓰기 로그 파일 (WAL 파일)이 포함되어 있습니다. 여기에는 배트맨 토토 중에 생성 된 모든 쓰기 로그가 포함됩니다. 방법이 아니라면없음지정되어 있습니다. 로그 아카이브를 참조 할 필요없이 추출 된 디렉토리에서 우체 마스터를 직접 시작할 수 있으므로 완전히 독립형 배트맨 토토이됩니다..
쓰기 로그를 수집하는 다음 방법이 지원됩니다.
n없음배트맨 토토에 쓰기 로그인을 포함하지 마십시오.
ffetch쓰기 로그 파일은 배트맨 토토 끝에 수집됩니다. 따라서이 필요합니다.Wal_keep_segments배트맨 토토이 끝나기 전에 로그가 제거되지 않을 정도로 높이 설정 될 매개 변수. 전송할 때 로그가 회전하면 배트맨 토토이 실패하여 사용할 수 없습니다.
TAR 형식 모드가 사용되면 쓰기 로그 파일이에 기록됩니다.base.tar파일.
SStream배트맨 토토이 생성되는 동안 쓰기 로그를 스트리밍합니다. 서버에 대한 두 번째 연결이 열리고 배트맨 토토을 실행하는 동안 쓰기 전달 로그를 병렬로 스트리밍하기 시작합니다. 따라서로 구성된 두 개의 연결을 사용합니다.max_wal_senders매개 변수. 클라이언트가 수신 된 쓰기 로그를 따라 잡을 수있는 한,이 모드를 사용하면 마스터에 추가 쓰기 로그를 저장할 필요가 없습니다.
TAR 형식 모드를 사용하면 쓰기 로그 파일이 별도의 파일로 기록됩니다.pg_wal.tar(서버가 10보다 빠른 버전 인 경우 파일의 이름이 지정됩니다pg_xlog.tar).
이 값은 기본값입니다.
-z-gzip기본 압축 레벨과 함께 TAR 파일 출력의 GZIP 압축을 활성화합니다. 압축은 TAR 형식을 사용할 때만 사용할 수 있으며 접미사.gz모든 타르 파일 이름에 자동으로 추가됩니다.
-z레벨-코프 프레스 =레벨TAR 파일 출력의 GZIP 압축을 활성화하고 압축 수준을 지정합니다 (0 ~ 9, 0은 압축이없고 9가 최상의 압축). 압축은 TAR 형식을 사용할 때만 사용할 수 있으며 접미사.gz모든 타르 파일 이름에 자동으로 추가됩니다.
다음 명령 줄 옵션은 배트맨 토토 생성 및 프로그램 실행을 제어합니다.
-c빠른 | 스프레드-체크 포인트 =빠른 | 스프레드체크 포인트 모드를 빠른 (즉시) 또는 스프레드 (기본값)로 설정합니다 (참조섹션 25.3.3).
-c-Create-Slot이 옵션은에 의해 이름이 지정된 복제 슬롯의 생성을 유발합니다-슬롯배트맨 토토을 시작하기 전에 옵션. 슬롯이 이미 존재하면 오류가 발생합니다.
-l레이블-label =레이블배트맨 토토에 대한 레이블을 설정합니다. 아무것도 지정되지 않으면의 기본값은“PG_BASEBACKUP베이스 배트맨 토토”사용됩니다.
-n-no-clean기본적으로,PG_BASEBACKUP오류가 발생하여 작업을 완료 할 수 없음을 발견하기 전에 생성 한 디렉토리를 제거합니다 (예 : 데이터 디렉토리 및 쓰기 로그 디렉토리). 이 옵션은 정리를 억제하므로 디버깅에 유용합니다.
테이블 스페이스 디렉토리가 어느 쪽이든 정리되지 않음에 유의하십시오.
-n-no-sync기본적으로PG_BASEBACKUP모든 파일이 디스크에 안전하게 작성 될 때까지 기다립니다. 이 옵션은PG_BASEBACKUP대기하지 않고 돌아 오는 것은 더 빠르지 만 후속 운영 체제 충돌로 인해 기본 배트맨 토토이 손상 될 수 있음을 의미합니다. 일반적 으로이 옵션은 테스트에 유용하지만 생산 설치를 만들 때 사용해서는 안됩니다.
-p-프로그램진행 상황보고를 활성화합니다. 이것을 켜면 배트맨 토토 중에 대략적인 진행률 보고서가 제공됩니다. 배트맨 토토 중에 데이터베이스가 변경 될 수 있으므로 근사치 일뿐 아니라 정확히 끝나지 않을 수 있습니다.100%. 특히 WAL Log가 배트맨 토토에 포함되면 총 데이터 양은 미리 추정 할 수 없으며이 경우 WAL없이 총 견적을 통과하면 추정 목표 크기가 증가합니다..
이것이 활성화되면 배트맨 토토은 전체 데이터베이스의 크기를 열거하여 시작하여 돌아가 실제 컨텐츠를 보냅니다. 이로 인해 배트맨 토토이 약간 오래 걸릴 수 있으며 특히 첫 번째 데이터가 전송되기까지 더 오래 걸립니다.
-sslotname-슬롯 =slotname이 옵션은와 함께 만 사용할 수 있습니다.-x stream. WAL 스트리밍이 지정된 복제 슬롯을 사용하게됩니다. 베이스 배트맨 토토이 복제 슬롯을 사용하여 스트리밍 복제 대기로 사용되도록하려면 동일한 복제 슬롯 이름을 사용해야합니다.복구 .conf. 이렇게하면 서버가 기본 배트맨 토토 종료 시간과 스트리밍 복제 시작 사이에 필요한 WAL 데이터를 제거하지 않도록합니다.
옵션이 아니라면 지정된 복제 슬롯이 존재해야합니다-c도 사용됩니다.
이 옵션이 지정되지 않고 서버가 임시 복제 슬롯 (버전 10 이상)을 지원하면 임시 복제 슬롯이 WAL 스트리밍에 자동으로 사용됩니다.
-v-VersboseVerbose 모드를 활성화합니다. 스타트 업 및 종료 중에 추가 단계를 출력 할뿐만 아니라 현재 처리가 활성화 된 경우 현재 처리중인 정확한 파일 이름을 표시합니다.
-no-slot이 옵션은 서버에서 지원하는 경우에도 배트맨 토토 중에 임시 복제 슬롯의 생성을 방지합니다.
옵션과 함께 슬롯 이름이없는 경우 임시 복제 슬롯이 기본적으로 생성됩니다.-s로그 스트리밍을 사용할 때.
이 옵션의 주요 목적은 서버가 무료 복제 슬롯이 없을 때베이스 배트맨 토토을 수행하는 것입니다. 복제 슬롯 사용은 거의 항상 선호됩니다. 배트맨 토토 중에 필요한 WAL이 서버에서 제거되는 것을 방지하기 때문입니다.
--No-Verify-Checksums서버에서 활성화되면 기본 배트맨 토토이 가져옵니다..
기본적으로 체크섬이 확인되고 체크섬 고장으로 인해 0이 아닌 출구 상태가 발생합니다. 그러나 마치 마치 마치 마치 인 경우 기본 배트맨 토토이 제거되지 않습니다.-no-clean옵션이 사용되었습니다.
다음 명령 줄 옵션은 데이터베이스 연결 매개 변수를 제어합니다.
-dconnstr-dbname =connstr서버에 연결하는 데 사용되는 매개 변수를 지정합니다.연결 문자열; 충돌하는 명령 줄 옵션을 무시합니다.
옵션은입니다.-dbname다른 클라이언트 응용 프로그램과의 일관성이 있지만PG_BASEBACKUP클러스터의 특정 데이터베이스에 연결하지 않으며 연결 문자열의 데이터베이스 이름은 무시됩니다.
-hhost-host =host서버가 실행중인 시스템의 호스트 이름을 지정합니다. 값이 슬래시로 시작하면 Unix 도메인 소켓의 디렉토리로 사용됩니다. 기본값은에서 가져옵니다.pghost환경 변수, 설정하면 UNIX 도메인 소켓 연결이 시도됩니다.
-p포트-포트 =포트서버가 연결을 듣고있는 TCP 포트 또는 로컬 UNIX 도메인 소켓 파일 확장자를 지정합니다. 기본값pgport환경 변수, 설정된 경우 또는 컴파일 된 기본값.
-s간격-Status-interval =간격서버로 다시 전송 된 상태 패킷 사이의 초 수를 지정합니다. 이를 통해 서버에서 진행 상황을보다 쉽게 모니터링 할 수 있습니다. 제로 값은 시간 초과 분리를 피하기 위해 서버에서 요청할 때 업데이트가 계속 전송되지만 정기 상태 업데이트를 완전히 비활성화합니다. 기본값은 10 초입니다.
-u사용자 이름--username =사용자 이름사용자 이름으로 연결합니다.
-w-no-password비밀번호 프롬프트를 발행하지 마십시오. 서버에 비밀번호 인증이 필요하고 A와 같은 다른 방법으로 암호를 사용할 수없는 경우.pgpass파일, 연결 시도가 실패합니다. 이 옵션은 비밀번호를 입력 할 사용자가없는 배치 작업 및 스크립트에 유용 할 수 있습니다.
-w--password힘PG_BASEBACKUP데이터베이스에 연결하기 전에 비밀번호를 신속하게하려면
이 옵션은 결코 필수적이지 않습니다.PG_BASEBACKUP서버가 암호 인증을 요구하는 경우 비밀번호를 자동으로 프롬프트합니다. 하지만,PG_BASEBACKUP서버가 암호를 원한다는 것을 알아내는 연결 시도를 낭비합니다. 어떤 경우에는 입력 할 가치가 있습니다-w추가 연결 시도를 피하려면
다른 옵션도 사용할 수 있습니다.
-v-버전인쇄PG_BASEBACKUP버전 및 종료.
-?-help도움말 표시PG_BASEBACKUP명령 줄 인수 및 종료.
이 유틸리티는 대부분의 다른 유틸리티PostgreSQL유틸리티, 지원하는 환경 변수를 사용합니다libpq(참조PostgreSQL : 문서 : 11 : 34.14. 환경 토토 사이트 순위).
배트맨 토토 시작시 서버에 검사 점을 작성해야합니다. 특히 옵션 인 경우-체크 포인트 = 빠른사용되지 않으면 시간이 걸릴 수 있습니다.PG_BASEBACKUP유휴 상태 인 것 같습니다.
배트맨 토토에는 PostgreSQL에서 관리하는 특정 임시 파일을 제외하고 구성 파일 및 제 3자가 디렉토리에 배치 한 추가 파일을 포함하여 데이터 디렉토리 및 테이블 스페이스의 모든 파일이 포함됩니다. 그러나 테이블 스페이스에 사용되는 상징적 링크가 보존된다는 점을 제외하고는 일반 파일과 디렉토리 만 복사됩니다. PostgreSQL에 알려진 특정 디렉토리를 가리키는 기호 링크는 빈 디렉토리로 복사됩니다. 다른 상징적 링크와 특수 장치 파일이 건너 뜁니다. 보다PostgreSQL : 문서 : 11 : 53.4. 토토 핫 복제 프로토콜정확한 세부 사항은
테이블 스페이스는 기본적으로 기본적으로 일반 형식으로 서버에있는 것과 동일한 경로로 배트맨 토토됩니다.--- 테이블 스페이스 맵핑가 사용됩니다. 이 옵션이 없으면 테이블 스페이스를 사용하는 경우 서버와 동일한 호스트에서 일반 형식베이스 배트맨 토토을 실행합니다. 배트맨 토토은 원래 테이블 스페이스와 동일한 디렉토리 위치에 기록되어야하므로.
TAR 형식 모드를 사용하는 경우 PostgreSQL 서버를 시작하기 전에 각 TAR 파일을 포장하는 것이 사용자의 책임입니다. 추가 테이블 스페이스가있는 경우 TAR 파일은 올바른 위치에서 포장을 풀어야합니다. 이 경우 해당 테이블 스페이스의 기호 링크는 서버에서의 내용에 따라 생성됩니다.TableSpace_map에 포함 된 파일base.tar파일.
PG_BASEBACKUP동일하거나 이전 주요 버전의 서버와 함께 9.1까지. 그러나 WAL 스트리밍 모드 (-x stream) 서버 버전 9.3 이상에서만 작동하며 TAR 형식 모드 (-Format = tar) 현재 버전의 서버 버전 9.5 이상에서만 작동합니다.
PG_BASEBACKUP두 가지 모두에서 그룹 권한을 보존합니다일반및타르소스 클러스터에서 그룹 권한이 활성화 된 경우 형식.
서버의 기본 배트맨 토토을 생성하려면MyDbserver로컬 디렉토리에 저장/usr/local/pgsql/data:
$PG_BASEBACKUP -H MYDBSERVER -D/USR/LOCAL/PGSQL/DATA
각 테이블 스페이스에 대해 압축 된 TAR 파일 하나로 로컬 서버의 배트맨 토토을 생성하고 디렉토리에 저장하려면배트맨 토토, 실행 중에 진행률 보고서 표시 :
$PG_BASEBACKUP -D 배트맨 토토 -FT -Z -P
단일 테이블 스페이스 로컬 데이터베이스의 배트맨 토토을 만들고BZIP2:
$PG_BASEBACKUP -D--FT -X FETCH | bzip2 backup.tar.bz2
(데이터베이스에 여러 테이블 스페이스가 있으면이 명령이 실패합니다.)
테이블 스페이스가있는 로컬 데이터베이스의 배트맨 토토을 생성하려면/opt/ts|./backup/ts:
$PG_BASEBACKUP -D 배트맨 토토/데이터 -T/OPT/TS = $ (PWD)/배트맨 토토/TS