| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
pg_dumpall는 한개의 스크립트 파일안의 클러스터의 모든PostgreSQL데이터베이스를 쓰기 위한 ("덤프 한다") 유틸리티입니다. 스크립트 파일에는 데이터베이스의 복구를 위해서 psql 에의 입력으로서 사용할 수 있는SQL명령이 포함되어 있습니다. 복구는 클러스터내의 각 데이터베이스에 대해서pg_dump를 호출하는 것으로 행해집니다. pg_dumpall는 또한 모든 데이터베이스에 공통되는 글로벌 오브젝트도 덤프 합니다 (pg_dump는 이러한 오브젝트를 보존하지 않습니다). 현시점에서는 이것에는 데이터베이스 사용자와 그룹, 데이터베이스 전체에 적용하는 액세스 제한에 관한 정보가 포함되어 있습니다.
pg_dumpall는 모든 데이터베이스로부터 테이블을 읽어들이기 때문에, 완전한 덤프를 작성하려면 아마 데이터베이스 슈퍼 유저로서 접속해야만 합니다. 게다가 사용자와 그룹을 추가하거나 데이터베이스를 작성하거나 보존된 스크립트를 실행하려면 슈퍼 유저 권한이 필요하게 되겠지요.
SQL 스크립트는 표준 출력에 기입해집니다. 그것을 파일에 리디렉트 하기 위해서는, 쉘의 연산자를 사용합니다.
pg_dumpall는,PostgreSQL서버에 몇번이나 접속해야할 필요가 있습니다(데이터베이스마다 한번씩 접속하게 됩니다). 패스워드 인증을 사용하고 있는 경우, 매번 패스워드 입력을 촉구받습니다. 그러한 경우는~/. pgpass파일을 준비해 두면 편리합니다. 자세한 것은 Section 29.13을 참조해 주세요.
이하의 명령 라인 옵션은 내용이나 출력 형식을 제어합니다.
데이터만을 덤프하고 schema(데이터 정의)를 덤프 하지 않습니다.
데이터베이스를 재작성하는 명령의 전에, 데이터베이스의 클린 업(삭제) 하는 명령을 써냅니다. 롤 및 테이블 공간용의DROP명령도 이와 같이 추가됩니다.
데이터를(COPY보다)INSERT명령으로서 덤프합니다. 이것을 실시하면 복구가 매우 늦어집니다. 주로PostgreSQL이외의 데이터베이스에 로드 가능한 덤프를 작성할 때에 유용합니다. 열의 순서를 변경했을 경우는 복구가 실패할 가능성이 있는 것에 주의해 주세요. 비록 속도가 저하되지만 -D옵션이 안전합니다.
명시적으로 렬명을 붙인INSERT명령 (INSERT INTO table ( column , ...) VALUES...)(으)로서 덤프 합니다. 이것에 의해 복구는 매우 늦어집니다. 주로,PostgreSQL이외의 데이터베이스에 로드에서 가능한 덤프를 작성할 때에 유용합니다.
글로벌 오브젝트(롤과 테이블 공간)만을 덤프 해, 데이터베이스의 덤프를 실시하지 않습니다.
pg_dumpall와 데이터 베이스 서버의 버젼의 불일치를 무시합니다.
pg_dumpall는 이전에 릴리스 된PostgreSQL데이터베이스를 취급할 수가 있지만, 매우 오래된 버젼(현시점에서는 7.0보다 전의 버젼)은 ㅊ 있습니다. 버젼 체크를 무효로 할 필요가 있는 경우에는, 이 옵션을 사용합니다(이 경우,pg_dumpall가 실패해도, 경고가 없었다고는 말하지 말아 주세요).
각 테이블의 오브젝트 식별자(OID)를 데이터의 일부로서 덤프 합니다. 애플리케이션으로OID열을(외부 키 제약 등) 참고하고 있다면 이 옵션을 사용해 주세요. 그 외의 경우는 이 옵션은 사용하지 말아 주세요.
오브젝트의 소유권을 원래의 데이터베이스에 일치시키기 위한 명령을 출력하지 않습니다. 기본값에서는 pg_dumpall는ALTER OWNER문 또는SET SESSION AUTHORIZATION문을 발행해 작성한 schema 요소의 소유권을 설정합니다. 슈퍼 유저(혹은, 스크립트내의 모든 오브젝트를 소유하는 사용자) 이외의 사용자가 스크립트를 실행했을 경우, 이러한 문장은 실패합니다. 임의의 유저가 복구할 수 있는 스크립트를 작성하려면, -O를 지정해 주세요. 다만, 이 경우는 모든 오브젝트의 소유자가 복구한 사용자가 되어 버립니다.
오브젝트 정의(schema)만을 덤프 해, 데이터를 덤프 하지 않습니다.
트리거를 무효로 할 때에 사용하는 슈퍼 유저의 사용자명을 지정해 주세요. 이것은 --disable-triggers를 사용하는 경우에게만 사용됩니다 (통상은 이 옵션을 사용하는 것보다도 출력된 스크립트를 슈퍼 유저 권한으로 실행하는 편이 좋을 것입니다).
장황(verbose) 모드를 지정합니다. 이것을 지정하면 pg_dumpall는 시작시각과 종료시각을 덤프 파일에 진행 메세지를 표준 에러에 출력하게 됩니다. 또, 이것에 의해pg_dump의 장황(verbose) 출력이 유효하게 됩니다.
액세스권한의 덤프(grant/revoke 명령)를 실시하지 않습니다.
이 옵션은 함수 본체용의 달러 인용부호의 사용을 무효로 해, 강제적으로 표준 SQL의 캐릭터 라인 구문을 사용한 인용부호부를 실시합니다.
이 옵션은 데이터만의 덤프를 할때만 사용합니다. 데이터의 리로드중에, 대상으로 하는 테이블상의 트리거를 일시적으로 사용 못하게 하기 위해 명령을 포함하도록 pg_dumpall에 지시합니다. 이 옵션은 데이터의 리로드중에는 호출하고 싶지 않은 참조 정합성 검사나 그 외의 트리거가 테이블상에 있는 경우에 사용합니다.
현재로서는--disable-triggers를 지정해 명령을 실행하는 것은 슈퍼 유저가 아니면 안됩니다. 그 때문에, 사용자는-S로 슈퍼 유저를 지정하든가 혹은 충분히 주의해 슈퍼 유저로서 스크립트 결과를 시작해야 합니다.
ALTER OWNER명령 대신에 표준 SQL의SET SESSION AUTHORIZATION명령을 오브젝트의 소유권을 위해 출력합니다. 이것에 의해 덤프의 표준에의 호환성이 높아지지만, 덤프내의 오브젝트의 이력에 따라서는 올바르고 복구되지 않을 가능성이 있습니다.
이하의 명령 라인 옵션은, 데이터베이스 접속 매개변수를 제어합니다.
데이터 베이스 서버가 가동하고 있는 머신의 호스트명을 지정합니다. 이 값이 slash로부터 시작되는 경우, Unix 도메인 소켓용의 디렉토리로서 사용됩니다. 기본값은 설정되어 있으면PGHOST환경 변수로부터 취득됩니다. 설정되어 있지 않으면 Unix 도메인 소켓 접속과 가정됩니다.
서버가 접속을 감시하는 TCP 포토 혹은 로컬 Unix 도메인 소켓 파일의 확장자(extension)를 지정합니다. 기본값이 설정되어 있는 경우, PGPORT환경 변수의 값이 됩니다. 설정되어 있지 않으면, 컴파일시의 기본값이 됩니다.
주어진 사용자로서 접속합니다.
패스워드 프롬프트를 띄웁니다. 이것은 만약 그 서버가 패스워드 인증을 요구한다면 자동적으로 나타날 것입니다.
기본값의 접속 매개변수입니다.
또, 이 유틸리티는 다른 대부분의PostgreSQL유틸리티와 같이 libpq로 지원되는 환경 변수를 사용합니다(Section 29.12를 참조해 주세요).
pg_dumpall는 내부에서pg_dump를 호출하므로, 진단 메세지의 일부에서는pg_dump를 참조하고 있습니다.
한번 복구 되어지면 최적화는 유용한 통계정보를 갖고 있을 수 있게 각각의 데이터베이스에 ANALYZE를 실행하는 것을 권합니다. 또, 모든 데이터베이스를 해석하기 위해 vacuumdb -a -z를 실행할 수 있습니다.
pg_dumpall에서는 필요한 테이블 공간용의 디렉토리가 복구전에 존재하고 있는 것을 요구합니다. 존재하지 않으면 기본값 이외의 장소에 있는 데이터베이스에 관해서 그 데이터베이스 생성이 실패합니다.