描述

pg_restore 是一个用于恢复由 pg_dump 以某种非纯文本格式转储的 Postgres 数据库的工具。

归档文件是 7.1 版新增的，它们包含足够的信息供 pg_restore 重建数据库，而且还允许 pg_restore 有选择地恢复其中的内容，甚至在恢复前重新排列各项的顺序。归档文件被设计为可跨体系结构移植。pg_dump 会产生重新生成所有用户定义类型、函数、表、索引、聚集和操作符所需的查询。此外，所有数据都会被复制出来（对脚本而言是文本格式），以便可以方便地再次复制回去。

pg_restore 读取归档文件，并根据命令参数按所需顺序输出相应的 SQL。显然，它无法恢复转储文件中不存在的信息；因此，如果转储是使用 “将数据转储为 INSERT 命令” 选项生成的，pg_restore 就不能使用 COPY 语句装载数据。

最灵活的输出文件格式是“自定义”格式（-Fc）。它允许选择和重排所有归档项，并且默认是压缩的。tar 格式（-Ft）不压缩，而且在装载时无法重排数据，但除此之外相当灵活。

要重新排列各项，首先需要转储归档的内容：

$ pg_restore archive.file -l > archive.list

这个文件由一个头部和每个项各占一行的内容组成，例如：

;
; Archive created at Fri Jul 28 22:28:36 2000
;     dbname: birds
;     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

分号是注释定界符，而行首的数字表示分配给每个项的内部归档 ID。

文件中的行可以被注释掉、删除并重新排序。例如：

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 archive.file -L archive.list

诊断

Connection to database 'template1' failed.
connectDBStart() -- connect() failed: No such file or directory
        Is the postmaster running locally
        and accepting connections on Unix socket '/tmp/.s.PGSQL.5432'?

注解

pg_restore 的局限性详述如下。

关于 pg_dump 的局限性的细节请参见 pg_dump 文档。

示例

要转储一个数据库：

$ pg_dump mydb > db.out

要重新装载这个数据库：

$ psql -d database -f db.out

要把一个名为 mydb 的包含 BLOB 的数据库转储到一个 tar 文件中：

$ pg_dump -Ft -b mydb > db.tar

要把这个数据库（连同 BLOB）重新装载到一个已存在的名为 newdb 的数据库中：

$ pg_restore -d newdb db.tar

参见