描述

pg_restore 是一个用于从 pg_dump 以非纯文本格式创建的归档中恢复 PostgreSQL 数据库的工具。它会发出重新生成所有用户定义类型、函数、表、索引、聚集和操作符以及表中数据所需的命令。

归档文件包含供 pg_restore 重建数据库的信息，同时还允许 pg_restore 有选择地恢复其中的内容，甚至在恢复前重新排列各项的顺序。归档文件被设计为可跨体系结构移植。

pg_restore 可以以两种模式运行：如果指定了数据库名，归档会被直接恢复到该数据库中。否则，会创建一个包含重建数据库所需 SQL 命令的脚本（并写入文件或标准输出），这与 pg_dump 纯文本格式创建的脚本类似。因此，一些控制脚本输出的选项与 pg_dump 的选项类似。

显然，pg_restore 无法恢复归档文件中不存在的信息。例如，如果归档是使用“将数据转储为 INSERT 命令” 选项生成的， pg_restore 就不能使用 COPY 语句装载数据。

选项

pg_restore 接受下列命令行参数。（长选项形式只在某些平台上可用。）

pg_restore 还接受以下用于连接参数的命令行参数：

环境

诊断

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'?

注解

如果你的安装在 template1 数据库中有任何本地添加内容， 请务必将 pg_restore 的输出装载到一个真正空的数据库中； 否则很可能会因为这些附加对象的重复定义而报错。要创建一个不带任何本地添加内容的空数据库， 应从 template0 而不是 template1 复制，例如：

CREATE DATABASE foo WITH TEMPLATE = template0;

pg_restore 的局限性详述如下。

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

示例

要转储一个数据库：

$ pg_dump mydb > db.out

要重新装载这个数据库：

$ psql -d database -f db.out

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

$ pg_dump -Ft -b mydb > db.tar

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

$ pg_restore -d newdb db.tar

要重新排列数据库项的顺序，首先需要转储归档的目录：

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

历史

pg_restore 工具最早出现在 PostgreSQL 7.1 中。

参见