描述

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还接受以下用于连接参数的命令行参数：

环境

与大多数其他 PostgreSQL 工具一样，此工具也使用 libpq 支持的环境变量（见 第 30.12 节）。

诊断

当使用 -d 选项指定直接数据库连接时， pg_restore 会在内部执行 SQL 语句。 如果运行 pg_restore 时遇到问题，请确保你能够使用例如 psql 从该数据库中查询信息。此外， libpq 前端库使用的任何默认连接设置和环境变量也都会生效。

注解

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

CREATE DATABASE foo WITH TEMPLATE template0;

pg_restore 的局限性详述如下。

关于 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，而是直接连接到要恢复到的数据库。还要注意，我们从 template0 而不是 template1 克隆新数据库，以确保它最初为空。

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

$ pg_restore -l db.dump > db.list

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

;
; Archive created at Mon Sep 14 13:55:39 2009
;     dbname: DBDEMOS
;     TOC Entries: 81
;     Compression: 9
;     Dump Version: 1.10-0
;     Format: CUSTOM
;     Integer: 4 bytes
;     Offset: 8 bytes
;     Dumped from database version: 8.3.5
;     Dumped by pg_dump version: 8.3.8
;
;
; Selected TOC Entries:
;
3; 2615 2200 SCHEMA - public pasha
1861; 0 0 COMMENT - SCHEMA public pasha
1862; 0 0 ACL - public pasha
317; 1247 17715 TYPE public composite pasha
319; 1247 25899 DOMAIN public domain0 pasha

分号表示一条注释的开始，而行首的数字表示分配给每个项的内部归档 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 db.list db.dump

参见