| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
pg_restore는 non-plain-text 형식 중 하나에서 pg_dump에 의해 생성된 아카이브(archive)파일로 부터 PostgreSQL데이터베이스를 복구하기 위한 유틸리티입니다. 이 명령은 데이터베이스를 복구 이루어 보존된 시점 상태로 하기 위해서 필요한 명령을 발행합니다. 그 아카이브(archive)파일은 또한 복구하는 내용을 선택하거나 복구하기 전에 아이템의 재배열을 실시하기위해서 pg_restore를 허락합니다. 아카이브(archive)파일은 아키텍쳐에 의존하지 않는 이식성을 가지도록 설계되고 있습니다.
pg_restore의 조작에는 2개의 모드가 있습니다. 데이터베이스명이 지정되었을 경우, 그 아카이브(archive)는 직접 지정한 데이터베이스에 복구 됩니다 데이터베이스명이 지정되지 않았던 경우는 데이터베이스를 재구축 하기 위해서 필요한 SQL 명령이 포함된 스크립트가 작성됩니다. 그리고 파일 혹은 표준 출력에 써내집니다. 이 스크립트의 내용은 pg_dump의 plain text 형식의 출력과 같습니다. 실제로 출력을 제어하는 옵션안에는 pg_dump의 옵션에 유사한 것이 있습니다.
당연히 pg_restore는 아카이브(archive)파일에 존재하지 않는 정보를 복구 할 수 없습니다. 예를 들면 아카이브(archive)가 "INSERT옵션으로서 데이터 덤프"를 사용해 작성된 것이었을 경우 pg_restore는 COPY 명령문을 사용해 데이터를 읽어들일 수 없습니다.
pg_restore는 이하의 명령 라인 인수를 받아들입니다.
복구 하는 아카이브(archive) 파일의 장소를 지정합니다. 지정이 없는 경우는 표준 입력이 사용됩니다.
데이터만을 복구 해 schema(데이터 정의)는 복구 하지 않습니다.
재작성전에 데이터베이스 오브젝트를 클린 업(삭제) 합니다.
복구전에 데이터베이스를 작성합니다 (이 옵션을 사용했을 때 -d로 지정한 데이터베이스는 최초의CREATE DATABASE명령의발행시에게만 사용됩니다. 그리고 모든 데이터는 아카이브(archive)내에 기술된 이름의 데이터베이스에 복구 됩니다).
dbname 데이터베이스에 접속해, 이 데이터베이스에 직접 복구 합니다.
데이터베이스에 SQL 명령을 송신중에 에러가 발생했을 경우, 처리를 종료합니다. 기본값에서는 처리를 속행해, 복구 처리의 마지막에 발생한 에러의 수를 표시합니다.
작성하는 스크립트 또는 -l를 사용했을 때 리스트를 위해 출력 파일을 지정합니다. 기본값은 표준 출력입니다.
아카이브(archive)의 형식을 지정합니다. pg_restore는 형식을 자동 인식하므로, 이 옵션은 필수가 아닙니다. 지정하는 값은 이하의 어느 쪽인가에 됩니다.
아카이브(archive)는 tar아카이브(archive)인 것을 나타냅니다. 데이터베이스를 복구 했을 때 이 아카이브(archive) 형식의 사용은 재배열과/또는 schema 요소를 제외할 수가 있습니다. 또, 복구시에 데이터의 일부만을 리로드 할 수도 있습니다.
아카이브(archive)가 pg_dump의 커스텀 형식인 것을 나타냅니다. 잉것은 가장 유연한 형식이며, 데이터 로드 뿐만이 아니라 schema 요소도 재배열할 수가 있습니다. 또, 이 형식은 기본값으로 압축됩니다.
데이터베이스의 버젼 체크를 무시합니다.
지정한 인덱스의 정의만을 복구합니다.
아카이브(archive)의 내용을 일람으로서 출력합니다. 이 오퍼레이션의 출력물은 보구된 아이템을 재한하고 재배열 하기 위해 -L옵션과 사용할 수가 있습니다.
list-file 내에서 지정한 요소만을 그 파일에서 나타나는 순서로 복구합니다. 행을 이동하거나 행의 선두에;를 붙여 comment out 하거나 하는 일도 가능합니다 (후술의 예를 참조해 주세요).
지정된 schema내의 오브젝트만을 복구합니다. 이것은 특정의 테이블만을 복구하기 위해서-t옵션과 조합할 수가 있습니다.
오브젝트의 소유권 원래의 데이터베이스에 맞추기 위한 명령을 출력하지 않습니다. 기본값에 의해 pg_restore는 ALTER OWNER또는 SET SESSION AUTHORIZATION명령문을 발행해, 작성한 schema 요소의 소유권을 설정합니다. 그 명령문은 데이터베이스에 최초로 접속했던 것이 슈퍼 유저(또는 그 스크립트내의 모든 오브젝트를 소유하는 사용자)가 아닌 경우, 실패할 것입니다. -O를 부여하면 초기 접속에 임의의 사용자 이름은 최초의 접속을 위해 사용 될 수 있고 이 사용자는 생성된 모든 오브젝트 소유하게 됩니다.
지정한 함수만을 복구합니다. 콘텐츠 테이블의 덤프 파일의에 나타나는 대로 함수나 인수의 이름을 스펠로 정확하게 입력하도록 주의해 주세요.
이 옵션은 폐지되었습니다. 그러나 후방 호환성을 보관 유지하기 위해서 받아들여지고 있습니다.
schema(데이터 정의)만을 복구해 데이터(테이블의 내용)를 복구하지 않습니다. 시퀀스의 현재가는 복구되지 않습니다. ("schema"라고 하는 용어를 다른 의미로 사용하는 --schema옵션과 혼동 하지 말아 주세요. )
트리거를 무효로 하는 경우에 사용하는 슈퍼 유저의 사용자 이름을 지정합니다. 이것은 --disable-triggers를 사용하는 경우에게만 사용됩니다.
지정된 테이블만 복구합니다(테이블 정의와/또는 데이터만을 대상으로 할 수도 있습니다).
지정된 트리거만을 복구합니다.
장황(verbose) 모드를 지정합니다.
액세스 권한(grant/revoke 명령)의 복구를 실시하지 않습니다.
이 옵션은 데이터만의 덤프를 작성할 때 밖에 적용되지 않습니다. 데이터의 리로드하는 동안 pg_restore에 대해 대상 테이블상의 트리거를 일시적으로 무효로 하는 명령을 실행하도록 지시합니다. 만약 이 옵션은 데이터의 리로드중에는 호출하고 싶지 않은 참조 정합성 검사나 그 외의 트리거가 있는 경우에 사용합니다.
현재로서는 --disable-triggers를 지정해 명령를 실행하는 것은 슈퍼 유저야 합니다. 그 때문에 사용자는-S로 슈퍼 유저를 지정하든가 혹은 PostgreSQL의 슈퍼 유저 권한으로 pg_restore를 실행할 필요가 있습니다.
ALTER OWNER명령 대신에 표준 SQL의 SET SESSION AUTHORIZATION명령을 출력해, 오브젝트의 소유권을 결정합니다. 이것은 덤프의 표준에의 호환성이 높아지지만, 덤프내의 오브젝트의 이력에 따라서는 올바르게 복구 되지 않을 가능성이 생깁니다.
기본값에 의해 테이블의 생성 명령이 실패한것(예를 들어, 이미 존재하는 등의 이유에 의해)조차 테이블 데이터는 복구됩니다. 이 옵션에 의해 테이블 데이터는 단지 무시되게 됩니다. 이것은 대상의 데이터베이스에 목적의 테이블의 내용이 포함되어 있을 때에 편리합니다. 예를 들어PostGIS등의PostgreSQL확장용의 보조 테이블이 이미 대상의 데이터베이스내에 존재할 가능성이 있습니다. 이 옵션을 지정하면 이중 로드나 쓸모없는 데이터의 로드를 막을 수가 있습니다.
이 옵션은 SQL 스크립트 출력을 생성할 때는 아니고, 직접 데이터베이스에 복구할 때에게만 효과적입니다.
pg_restore는 한층 더 이하의 명령 라인 인수를 접속 매개변수로서 받아들입니다.
서버가 실행하고 있는 머신의 호스트명을 지정합니다. 만약 이 값이 slash로부터 시작되는 경우, Unix 도메인 소켓용의 디렉토리로서 사용됩니다. 기본값은 설정되어 있으면PGHOST환경 변수로부터 취득됩니다. 설정되어 있지 않으면, Unix 도메인 소켓 접속과 가정됩니다.
서버가 접속을 감시하는 TCP 포토 혹은 로컬 Unix 도메인 소켓 파일의 확장자(extension)를 지정합니다. 기본값이 설정되어 있는 경우나 컴파일 되있는 것이 기본값일 경우 PGPORT환경 변수의 값이 기본이 됩니다.
접속 유저명입니다.
패스워드 프롬프트가 입력이 압박됩니다. 만약 서버가 패스워드 입력이 요구된다면 이것은 자동적으로 일어납니다.
복구를 단일 트랜잭션(transaction)로서 실행합니다 (즉 발행하는 명령을 BEGIN/COMMIT로 둘러쌉니다). 이것에 의해 확실히, 모든 명령이 완전하게 성공되거나 전혀 변경이 이루어지지 않게 됩니다. 이 옵션은--exit-on-error를 의미합니다.
기본의 접속 매개변수입니다.
이 이 유틸리티는 다른 대부분의PostgreSQL유틸리티와 같이 libpq로 지원되는 환경 변수를 사용합니다(Section 29.12를 참조해 주세요).
데이터베이스에 직접 접속할 때, -d옵션의 사용이 지정됩니다. pg_restore는 내부에서SQL문을 실행합니다. pg_restore의 실행시에 문제가 발생하는 경우는 psql 등을 사용해, 그 데이터베이스 사용으로 부터 정보를 선택할 수 있는 것을 확인해 주세요. 또,libpqfront-end 라이브러리가 적용되는 것에 의해 기본 접속 설정과 환경 변수가 사용됩니다.
설치가 template1데이터베이스에 대해 로컬인 변경을 실시하고 있는 경우, pg_restore의 출력은 확실히 빈 데이터베이스에 로드하도록 주의해 주세요. 그렇게 하지 않으면 아마 추가된 오브젝트의 중복 정의에 의해 에러가 발생합니다. 로컬 추가가 반영없이 빈 데이터베이스를 작성하려면 template1는 아니고template0를 카피해 주세요. 이하에 예를 나타냅니다.
CREATE DATABASE foo WITH TEMPLATE template0;
pg_restore의 제한을 자세히 이하에 나타냅니다.
--disable-triggers옵션을 사용해 기존의 존재한 테이블에 데이터를 복구할 때, pg_restore는 데이터를 삽입하기 전에, 사용자 테이블상의 트리거를 무효로 하는 명령문을 발행한 후 데이터의 삽입이 완료한 다음에, 그것들을 다시 유효하게 하는 명령문를 발행합니다. 복구가 도중에 정지했을 경우, 시스템 카탈로그가 부적절한 상태대로 되어 있을 가능성이 있습니다.
pg_restore는 개별의 테이블의 라지 오브젝트을 복구하지 않을 것입니다. 만약 아카이브(archive)에 라지 오브젝트가 포함되어 있는 경우, 모든 라지 오브젝트가 복구됩니다.
pg_dump의 제한에 대한 자세한 것은 pg_dump의 문서를 참조해 주세요.
즉시 복구되었고 복구한 테이블 각각 대해ANALYZE를 실행하고 최적화가 유용한 통계 정보를 가지도록 하는 것을 추천합니다.
mydb라는 이름의 데이터베이스를 커스텀 서식의 덤프 파일에 덤프 하고 있는 것과 가정합니다.
$ pg_dump -Fc mydb > db.dump
데이터베이스를 삭제해, 덤프 파일로부터 재작성합니다.
$ dropdb mydb $ pg_restore -C -d postgres db.dump
-d스위치의 데이터베이스 이름에는 클러스터에 존재하는 데이터베이스를 지정할 수가 있습니다. pg_restore는 예를 들면mydb에 대한CREATE DATABASE명령을 발행하기 위해 그것을 사용합니다. -C를 붙이면 데이터는 항상 덤프 파일내에 기재된 이름의 데이터베이스에 복구됩니다.
newdb라고 하는 새로운 데이터베이스에 덤프 파일을 리로드됩니다.
$ createdb -T template0 newdb $ pg_restore -d newdb db.dump
-C를 사용하고 있지 않는 것에 주목해 주세요. 대신에 복구하는 데이터베이스에 직접 접속하고 있습니다. 또, 새로운 데이터베이스를 확실히 초기 상태를 비우기 위해 template1는 아니고 template0로부터 복사해 작성한 점에도 주목해 주세요.
데이터베이스의 아이템을 재배열 하려면 , 우선 이 아카이브(archive)의 내용의 테이블을 덤프 하지 않으면 안됩니다.
$ pg_restore -l db.dump > db.list
파일 리스트는 헤더와 각 아이템의 1행으로 나타낸 것으로부터 구성됩니다.
; ; Archive created at Fri Jul 28 22:28:36 2000 ; dbname: mydb ; TOC Entries: 74 ; Compression: 0 ; Dump Version: 1.4-0 ; Format: CUSTOM ; ; ; Selected TOC Entries: ; 2; 145344 TABLE species postgres 3; 145344 ACL species 4; 145359 TABLE nt_header postgres 5; 145359 ACL nt_header 6; 145402 TABLE species_records postgres 7; 145402 ACL species_records 8; 145416 TABLE ss_old postgres 9; 145416 ACL ss_old 10; 145433 TABLE map_resolutions postgres 11; 145433 ACL map_resolutions 12; 145443 TABLE hs_old postgres 13; 145443 ACL hs_old
세미콜론으로 시작되는 행은 명령입니다. 행의 선두의 번호는 각 아이템에 할당할 수 있었던 내부 아카이브(archive) ID를 나타냅니다.
이 파일의 각 행에 대해서 comment out, 삭제, 재배열을 실시할 수가 있습니다. 이하에 예를 나타냅니다.
10; 145433 TABLE map_resolutions postgres ;2; 145344 TABLE species postgres ;4; 145359 TABLE nt_header postgres 6; 145402 TABLE species_records postgres ;8; 145416 TABLE ss_old postgres
이 파일을 pg_restore의 입력으로서 이용하고, 아이템 10과 6을, 이 차례로 복구할 수가 있습니다.
$ pg_restore -L db.list db.dump