| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
pg_dump는PostgreSQL데이터베이스를 백업 하는 유틸리티입니다. 데이터베이스를 사용중이어도 일관성이 있는 백업을 작성할 수가 있습니다. pg_dump는 다른 사용자에 의한 데이터베이스에의 액세스(읽고 쓰기)를 막지 않습니다.
덤프(추출)는, 스크립트 형식, 또는, archive파일 형식에서 출력물이 될 수가 있습니다. 스크립트 덤프는, 보존시 상태의 데이터베이스를 복구성 하기 위해서 필요한 SQL 명령이 기입해진 프레인테키스트파일입니다. 이 스크립트를 사용해 복구하려면 psql 를 사용합니다. 스크립트 파일을 사용하면 덤프를 실시한 것과는 다른 머신이나 다른 아키텍쳐상에서도 데이터베이스를 재구축 할 수가 있습니다. 또, 다소 편집하면 다른 SQL 데이터베이스 제품상에서도 데이터베이스의 재구축이 가능합니다.
그 대안의 archive파일 형식은 사용해 데이터베이스를 재구축 하려면 pg_restore를 사용해야만 합니다. 이 파일을 사용하면,pg_restore가 복구 대상을 선택하거나 restore 하는 아이템을 줄서 바꾸거나 할 수 있습니다. archive파일도 또, 아키텍쳐를 넘어 이식할 수 있도록 설계되고 있습니다.
몇개의 archive파일 형식을pg_restore와 조합해 사용하는 경우는 pg_dump의 유연한 아카이브(archive)/전송 기구를 이용할 수 있습니다. 구체적으로는,pg_dump를 사용해 데이터베이스 전체를 백업 해 pg_restore를 사용해 아카이브(archive)의 내용을 검사하거나 데이터베이스의 일부를 선택해 복구하거나 할 수가 있습니다. 가장 유연한 출력 파일 형식은,"custom"형식(-Fc)입니다. 이 형식에서는 모든 아카이브(archive) 아이템의 수집, 재배열이 실시되고 기본값으로 압축합니다. tar형식(-Ft)은 압축되지 않습니다. 또, 로드 시에 줄서 바꾸고를 실시할 수가 없습니다. 그러나 다른 점에서 꽤 유연합니다. 게다가tar와 같이 표준적인 Unix 툴을 사용해 조작할 수가 있습니다.
pg_dump의 실행중에 모든 특히 후술의 제한에 관한 경고(표준 에러에 출력되는)가 출력되어 있지 않은가 확인해 주세요.
이하의 명령 라인 옵션은 출력 형식과 그 내용을 제어합니다.
덤프(추출) 하는 데이터베이스의 이름을 지정합니다. 지정되어 있지 않은 경우는,PGDATABASE환경 변수가 사용됩니다. 이 변수도 설정되어 있지 않은 경우는, 접속을 위해서 지정된 유저명이 사용됩니다.
데이터만을 덤프 해, schema(데이터 정의)는 덤프 하지 않습니다.
이 옵션은 plain-text 형식의 경우에게만 유효합니다. 아카이브(archive) 형식에서는,pg_restore를 호출할 때에 이 옵션을 지정할 수가 있습니다.
라지 오브젝트를 덤프에 포함합니다. 이것은 기본값의 동작입니다만 --schema, --table, --schema-only가 지정되었을 경우는 예외입니다. 따라서 -bswitch은 선택적인 덤프에 라지 오브젝트를 추가하는 경우에게만 유용합니다.
그 명령을 생성하기 전에 데이터베이스 객체를 삭제하기 위해 명령을 출력합니다.
이 옵션은 plain-text 형식의 경우에게만 유효합니다. 아카이브(archive) 형식에서는 pg_restore를 호출할 때에 이 옵션을 지정할 수가 있습니다.
처음에 데이터베이스 자체를 작성하는 명령을 출력해, 그 후, 작성한 데이터베이스에 접속하는 명령을 출력합니다. (이러한 형식의 스크립트를 사용하면, 스크립트를 실행하기 전에 어느 데이터베이스에 접속하면 좋을것인가 라고 하는 문제를 생각할 필요가 없어집니다).
이 옵션은 plain-text 형식의 경우에게만 유효합니다. 아카이브(archive) 형식에서는 pg_restore를 호출할 때에 이 옵션을 지정할 수가 있습니다.
(COPY보다) INSERT명령으로 데이터를 덤프 합니다. 이것을 실시하면 복구하는데 매우 시간이 걸립니다. 주로PostgreSQL이외의 데이터베이스에 로드 가능한 덤프를 작성할 때에 유용합니다. 또, 이 옵션은 각 행에 대해서 다른 커멘드를 생성하기 때문에, 일행을 재로드할 때에 에러가 되었다고 해도, 테이블의 내용 통째로 없어지는 일 없이, 일행만이 없어질 뿐입니다. 열의 순서를 변경했을 경우는 복구가 실패할 가능성이 있는 것에 주의해 주세요. -D옵션이 처리가 늦어지지만, 열의 순서 변경에 대해서 안전합니다.
명시적으로 렬명을 붙인INSERT명령(INSERT INTO table ( column , ...) VALUES...)(으)로서 데이터를 덤프 합니다. 이것에 의해 복구는 매우 늦어집니다. 주로 PostgreSQL이외의 데이터베이스에 로드 가능한 덤프를 작성할 때에 유용합니다. 또, 이 옵션은 각 행에 대해서 다른 명령를 생성하기 때문에, 일행을 재로드할 때에 에러가 되었다고 해도, 테이블의 내용 통째로 없어지는 일 없이 일행만이 없어질 뿐입니다.
지정한 캐릭터 세트 encode 방식으로 덤프를 작성합니다. 기본값에 의해 덤프는 데이터베이스의 encode 방식에서 작성됩니다 (PGCLIENTENCODING환경 변수를 기호의 덤프시의 encode 방식으로 설정하는 것으로, 같은 결과를 얻을 수 있습니다).
출력을 지정의 파일에 보냅니다. 생략시는 표준 출력이 사용됩니다.
출력 형식을 선택합니다. format 에는 이하 중 한쪽이 들어갑니다.
plain-text의SQL스크립트 파일을 출력합니다(기본값).
pg_restore에의 입력에 적절한 커스텀 아카이브(archive)를 출력합니다. 이것은 가장 유연한 형식이며, 오브젝트 정의뿐만 아니라 로드하는 데이터를 재배열 할 수가 있습니다. 또, 이 형식은 기본값으로 압축됩니다.
pg_restore에의 입력에 적절한tar아카이브(archive)를 출력합니다. 이 아카이브(archive) 형식에서는 줄서 바꾸고나 데이터베이스 오브젝트를 제외하는 데이터베이스의 restore를 실시할 수가 있습니다. 또, 복구시에 데이터를 선택해 리로드 할 수도 있습니다.
pg_dump와 데이터베이스 서버의 버젼의 불일치를 무시합니다.
pg_dump는 PostgreSQL 실행중의 과거의 릴리스의로부터 덤프 할 수가 있습니다. 그러나 (현시점에서는 7.0보다 전의) 매우 낡은 버젼의 데이터베이스는 지원되지 않습니다. 사용하는 pg_dump보다 새로운 서버로부터 덤프 하는 것은 대부분의 경우 할 수 없습니다. 버젼 체크를 무효로 할 필요가 있는 경우에는 이 옵션을 사용합니다. (이 경우 pg_dump가 실패해도 경고 표시가 되지 않습니다.)
schema 에 일치하는 schema만을 덤프 합니다. 이것은 schema 자체와 거기에 포함되는 오브젝트 모든 것을 선택합니다. 이 옵션이 지정되지 않으면, 대상 데이터베이스내에 있는 시스템 이외의 schema 모두가 덤프 됩니다. 복수의-n옵션을 기술하는 것으로 복수의 schema를 선택할 수가 있습니다. 또, schema 매개변수는 psql의\d명령과 같은 규칙에 따르는 패턴으로서 해석됩니다. ( 패턴 참조) 그러므로, 와일드 카드 문자를 패턴내에 기술하는 것으로, 복수의 schema를 선택할 수도 있습니다. 와일드 카드를 사용할 때는 쉘에 의해 그 와일드 카드를 전개시키지 않게 패턴을 인용한다는 것을 주의하세요.
Note: -n가 지정되면,pg_dump는 선택한 schema내의 오브젝트가 의존할 가능성이 있는 다른 데이터베이스 오브젝트의 덤프를 실시하지 않습니다. 따라서, 지정된 schema 덤프 결과가 초기 상태의 데이터베이스에 정상적으로 복구 할 수 있을지 보증은 없습니다.
Note: -n가 지정되면 blob와 같은 비schema 오브젝트는 덤프 되지 않습니다. --blobs스윗치를 붙여 덤프를 실시하는 것으로 blob도 추가됩니다.
schema 패턴에 일치하는 schema를 덤프 하지 않습니다. 이 패턴은-n와 같은 규칙에 따라 해석됩니다. -N는 몇가지 패턴 중 어느 것에 일치하는 schema를 제외하는 것보다 더 많이 지정될 수 있습니다.
-n와-N의 양쪽 모두가 지정되었을 경우, 적어도 1개의-n에 일치해-N옵션에 일치하지 않는 schema만이 덤프 됩니다. -n없이 -N가 지정되었을 경우, -N에 일치하는 schema는 그 밖의 통상의 덤프로부터 제외됩니다.
각 테이블의 데이터 일부로서 오브젝트 식별자(OID)를 덤프 합니다. 애플리케이션으로OID열을(외부 키 제약 등) 어떠한 형태로 사용하고 있는 경우는 이 옵션을 사용해 주세요. 그 외의 경우는, 이 옵션은 사용하지 말아 주세요.
오브젝트의 소유권을 원의 데이터베이스에 일치시키기 위한 명령을 출력하지 않습니다. 기본값에서는 pg_dump는 작성한 데이터베이스 오브젝트의 소유권을 설정한 ALTER OWNER문 또는 SET SESSION AUTHORIZATION문을 발행합니다. 슈퍼 유저(혹은 그 스크립트 내의 모든 오브젝트를 소유하는 사용자) 이외의 사용자가 스크립트를 실행했을 경우, 이러한 문장은 실패합니다. 임의의 사용자가 복구할 수 있는 스크립트를 작성하려면 ,-O를 지정해 주세요. 다만, 이 경우는 모든 오브젝트의 소유자가 복구한 사용자가 되어 버립니다.
이 옵션은 plain-tex 형식의 경우에게만 유효합니다. 아카이브(archive) 형식에서는 pg_restore를 호출할 때에 이 옵션을 지정할 수가 있습니다.
이 옵션은 폐지되었습니다만, 후방 호환성을 보관 유지하기 위해 받아들여집니다.
데이터 정의(schema)만을 덤프 하고, 데이터는 덤프 하지 않습니다.
trigger를 무효로 하는 경우에 사용하는, 슈퍼 유저의 유저명을 지정합니다. 이것은 --disable-triggers를 사용하는 경우에게만 사용됩니다 (통상은 이 옵션을 사용하는 것보다도 슈퍼 유저로서 출력된 스크립트를 실행하는 편이 좋을 것입니다).
table 에 일치하는 테이블(또는 뷰나 순서)만을 덤프 합니다. 복수의-t옵션을 기술하는 것으로 복수의 테이블을 선택할 수가 있습니다. 또, table 매개변수는 psql의 \d명령으로 사용되는 규칙과 같은 규칙에 따르는 패턴으로서 해석됩니다. 그러므로, 와일드 카드 문자를 패턴내에 기술하는 것으로 복수의 테이블을 선택할 수도 있습니다. 와일드 카드를 사용할 때는 쉘에 의해 그 와일드 카드를 전개시키지 않게 패턴을 인용하는 것을 주의해 주세요.
-t가 사용되면(자),-n및-N옵션의 효과는 없어집니다. 왜냐하면 -t로 선택한 테이블이, 이러한 옵션과는 관계없이 덤프 되어 또, 비테이블 오브젝트는 덤프 되지 않기 때문입니다.
Note: -t가 지정되면(자),pg_dump는 선택한 테이블내의 오브젝트가 의존할 가능성이 있는 다른 데이터베이스 오브젝트의 덤프를 실시하지 않습니다. 따라서, 지정된 테이블 덤프 결과가 초기화된 데이터베이스에 정상적으로 복구할 수 있을지의 보증은 없습니다.
Note: -t옵션의 동작은 8.2보다 전의 버젼의PostgreSQL와 완전한 호환성은 없습니다. 이전에는,-t tab라고 기술하는 것으로tab라는 이름의 테이블을 모두 덤프 하고 있었습니다. 그러나 현재는 기본 검색 패스로 보이는 것만이 덤프 됩니다. 과거의 동작을 실시하기 위해서(때문에)는 -t '*. tab'와 기술해 주세요. 또, 특정의 schema내의 테이블을 선택하기 위해서는 -n sch -t tab의 오래된 관영어 보다 -t sch.tab와 같은 것을 기술해야만 합니다.
tables 패턴에 일치하는 경우, 덤프 하지 않습니다. 이 패턴은-t와 같은 규칙에 따라 해석됩니다. -T는 복수 지정하는 것으로 몇몇 패턴에 일치하는 일치하는 테이블을 제외하는 것 보다 더 주어질 수 있습니다.
-t와-T의 양쪽 모두가 지정되었을 경우, 적어도 1개의 -t옵션에 일치하고 -T옵션에 일치하지 않는 테이블만이 덤프 됩니다. -t없이 -T가 지정되었을 경우, -T에 일치하는 테이블은 그 밖의 통상의 덤프로부터이 제외됩니다.
verbose 모드를 지정합니다. 이것을 지정하면, pg_dump는 상세한 오브젝트 명령, 개시시각, 종료시각을 덤프 파일에 진행 상황 메세지를 표준 에러에 출력합니다.
액세스권한(grant/revoke 명령)의 덤프를 억제합니다.
이 옵션은 함수 본체용의 달러 인용부호의 사용을 무효로 하고, 강제적으로 표준 SQL의 string 구문을 사용한 인용부호를 실시합니다.
이 옵션은 데이터만의 덤프를 작성하는 경우 밖에 적용되지 않습니다. 데이터의 리로드중에 pg_dump에 대해 대상 테이블상의 trigger를 일시적으로 무효로 하는 명령을 출력하도록 지시합니다. 이 옵션은 만약 정합성 검사나 데이터의 리로드중에는 호출하고 싶지 않은 참조 테이블상에 trigge가 있는 경우에 사용합니다.
현재로서는 --disable-triggers를 지정해 명령을 실행하는 것은 슈퍼 유저가 아니면 안됩니다. 그 때문에 사용자는-S로 슈퍼 유저 이름을 지정하든가 혹은 충분히 주의해 슈퍼 유저 권한으로 스크립트를 시작할 필요가 있습니다(후자가 보다 바람직한 방법입니다).
이 옵션은 plain-text 형식의 경우에게만 유효합니다. 아카이브(archive) 형식에서는 pg_restore를 호출할 때에 이 옵션을 지정할 수가 있습니다.
오브젝트의 소유권을 결정하기 위해서 ALTER OWNER명령 대신에 표준 SQL의 SET SESSION AUTHORIZATION명령을 출력합니다. 이것에 의해 덤프의 표준에의 호환성이 높아집니다만, 덤프내의 오브젝트의 이력에 따라서는 올바르게 복구되지 않을 가능성이 생깁니다. 또,SET SESSION AUTHORIZATION를 사용한 덤프를 올바르고 복구하기 위해서는 확실히 슈퍼 유저 권한이 필요합니다. ALTER OWNER로 필요한 권한은 이것보다 적게 됩니다.
압축을 서포트하는 아카이브(archive) 형식에서 사용하는 압축 레벨을 지정합니다(현시점에서는 관습(custom) 어카이브(archive) 형식만이 압축을 지원하고 있습니다).
이하의 명령 라인 옵션은, 데이터베이스 접속 파라미터를 제어합니다.
서버가 가동하고 있는 머신의 호스트명을 지정합니다. 이 값이 slash로부터 시작되는 경우, Unix 도메인 소켓용의 디렉토리로서 사용됩니다. 기본값으로 설정되어 있으면PGHOST환경 변수로부터 취득됩니다. 설정되어 있지 않으면 Unix 도메인 소켓 접속과 가정됩니다.
서버가 접속을 감시하는 TCP 포토 혹은 로컬 Unix 도메인 소켓 파일의 확장자(extension)를 지정합니다. 기본값이 설정되어 있는 경우나 컴파일이 기본값으로 되어 있는 경우, PGPORT환경 변수의 값이 됩니다.
접속 사용자명입니다.
데이터베이스에 접속하기 전에 pg_dump는 강제적으로 패스워드 입력을 재촉합니다.
기본값의 접속 매개변수입니다.
또, 이 유틸리티는 다른 대부분의PostgreSQL유틸리티와 같이libpq로 지원되는 환경 변수를 사용합니다(Section 29.12를 참조해 주세요).
pg_dump는 내부에서SELECT 명령문을 실행합니다. pg_dump의 실행시에 문제가 발생하는 경우는 예를 들어, psql 등을 사용해 그 데이터베이스로부터 정보를 선택할 수 있는 것을 확인해 주세요. 또 libpq front-end 라이브러리에서 적용되는 기본의 접속 설정이나 환경 변수도 적용됩니다.
데이터베이스 클러스터에 대해template1데이터베이스에 대해 로컬인 변경을 실시하고 있는 경우, pg_dump의 출력은 확실히 빈 데이터베이스에 복구하도록 주의해 주세요. 그렇게 하지 않으면 아마 추가된 오브젝트의 중복 정의에 의해 에러가 발생합니다. 로컬인 추가가 반영되어 있지 않은 빈 데이터베이스를 작성하려면template1는 아니고template0를 복사해 주세요. 이하에 예를 나타냅니다.
CREATE DATABASE foo WITH TEMPLATE template0;
pg_dump has a few limitations: --> pg_dump에는 몇개의 제한이 있습니다.
--disable-triggers옵션을 사용해, 데이터만의 덤프를 실시하는 경우, pg_dump는 데이터를 삽입하기 전에 사용자 테이블에 trigger를 무효로 하는 명령문을 발행해, 데이터의 삽입이 완료한 다음에 그것들을 다시 유효하게 하는 명령문을 발행합니다. 복구가 도중에 정지했을 경우, 시스템 카탈로그가 부적절한 상태대로 되어 있을 가능성이 있습니다.
tar 아카이브(archive)의 멤버의 사이즈는 8기가바이트 미만에 제한되고 있습니다 (이것은 tar 파일 형식 자체가 가지고 있는 제한입니다). 그 때문에, 어느쪽이든 1개의 테이블의 텍스트 표현이 이 사이즈를 넘는 경우, 이 형식은 사용할 수 없습니다. tar 아카이브(archive)와 그 외의 출력 형식의 합계 사이즈에는 제한이 없습니다. 다만 operating system에 의한 제한이 있는 경우가 있습니다.
pg_dump가 생성하는 덤프 파일에는 쿼리문의 계획 결정의 최적와에 의해 사용되는 통계 정보가 포함되어 있지 않습니다. 그 때문에 충분한 성능을 발휘하기 위해서 덤프 파일로부터 복구한 다음에ANALYZE를 실행하는 것을 추천합니다.
pg_dump는 새로운 버젼의PostgreSQL에의 데이터 이행에 사용되기 때문에 pg_dump의 출력은 새로운 버젼의PostgreSQL 데이터베이스에 로드할 수 있게 되어 있습니다. 또, 오래된 PostgreSQL데이터베이스를 읽어낼 수도 있습니다. 그러나 통상 새로운PostgreSQL 데이터베이스의 독해나 오래된 버젼의 데이터베이스에 로드하기 위한 덤프 출력을 생성할 수 없습니다. 이것을 실시하려면 , 아마 덤프 파일의 수작업에 의한 수정이 필요하게 됩니다.
mydb라는 이름의 데이터베이스를 SQL 스크립트 파일에 덤프 합니다.
$ pg_dump mydb > db.sql
newdb라는 이름의(신규에 작성한) 데이터베이스에 스크립트를 재로드합니다.
$ psql -d newdb -f db.sql
관습(custom) 서식의 아카이브(archive)파일에 데이터베이스를 덤프 합니다.
$ pg_dump -Fc mydb > db.dump
newdb라는 이름의(신규에 작성한) 데이터베이스에 아카이브(archive)파일을 재로드합니다.
$ pg_restore -d newdb db.dump
mytab라는 이름의 단일의 테이블을 덤프 합니다.
$ pg_dump -t mytab mydb > db.sql
detroitschema내의emp로부터 시작되는 이름의 테이블을 모두 덤프 합니다. 다만, employee_log라는 이름의 테이블은 제외합니다.
$ pg_dump -t 'detroit.emp*' -T detroit.employee_log mydb > db.sql
east또는west로 시작되어gsm로 끝나는 schema를 모두 덤프 합니다. 다만, test라고 하는 단어를 포함한 경우는 제외합니다.
$ pg_dump -n 'east*gsm' -n 'west*gsm' -N '*test*' mydb > db.sql
정규 표현 기법을 사용해 옵션을 정리한 형태로 같은 것을 실시합니다.
$ pg_dump -n '(east|west)*gsm' -N '*test*' mydb > db.sql
ts_로부터 시작되는 이름의 테이블을 제외해, 모든 데이터베이스 오브젝트를 덤프 합니다.
$ pg_dump -T 'ts_*' mydb > db.sql
대문자 또는 대문자 소문자 혼재의 이름을-t등의 switch로 지정하려면 , 이름을 이중 인용부호로 괄등 없으면 안됩니다. 그렇지 않으면 소문자에 변환됩니다. ( 패턴 )(을)를 참조해 주세요. ) 그러나, 이중 인용부호는 쉘로도 특별히 다루어지기 때문에, 이것도 인용부호로 괄등 없으면 안됩니다. 따라서, 대문자 소문자 혼재의 이름을 가지는 테이블을 1개 덤프 하려면 , 이하와 같이 하지 않으면 안됩니다.
$ pg_dump -t '"MixedCaseName"' mydb > mytab.sql