pg_restore

指定要恢复的归档文件所在位置（对于目录格式归档则为目录）。如果未指定，则使用标准输入。

仅恢复数据，不恢复模式（数据定义）或统计信息。如果归档中包含，则会恢复表数据、大对象和序列值。

此选项类似于指定 --section=data，但出于历史原因，两者并不完全相同。

在恢复数据库对象之前，发出 DROP 命令以删除将要恢复的所有对象。此选项适用于覆盖现有数据库。如果目标数据库中有任何对象不存在，则会报告可忽略的错误消息，除非同时指定了 --if-exists。

在向其中恢复之前先创建数据库。如果同时指定了 --clean，则会在连接到目标数据库之前先删除并重新创建它。

使用 --create 时，pg_restore 还会恢复数据库的注释（如果有）以及该数据库专有的任何配置变量设置，也就是任何提到该数据库的 ALTER DATABASE ... SET ... 和 ALTER ROLE ... IN DATABASE ... SET ... 命令。除非指定了 --no-acl，还会恢复数据库本身的访问权限。

使用此选项时，由 -d 指定的数据库仅用于发出初始的 DROP DATABASE 和 CREATE DATABASE 命令。所有数据都会恢复到以归档中记录的名称命名的数据库。

连接到数据库 dbname，并直接恢复到该数据库中。dbname 可以是一个连接字符串。如果是这样，连接字符串参数会覆盖任何冲突的命令行选项。

如果在向数据库发送 SQL 命令时遇到错误，则退出。默认行为是继续执行，并在恢复结束时显示错误计数。

指定生成脚本的输出文件，或者在与 -l 一起使用时指定列表输出文件。使用 - 表示 stdout。

指定归档格式。不必指定格式，因为 pg_restore 会自动确定格式。如果指定，可以是以下格式之一：

仅恢复指定名称的索引的定义。可以通过多次指定 -I 来恢复多个索引。

将 pg_restore 中最耗时的步骤，也就是装载数据、创建索引或创建约束，最多使用 number-of-jobs 个并发会话并行执行。此选项可以显著缩短将大型数据库恢复到运行在多处理器机器上的服务器所需的时间。当生成脚本而不是直接连接到数据库服务器时，此选项会被忽略。

每个作业都是一个进程或一个线程，具体取决于操作系统，并使用一个到服务器的独立连接。

此选项的最佳取值取决于服务器、客户端和网络的硬件配置。影响因素包括 CPU 核心数和磁盘配置。一个较好的起点是服务器上的 CPU 核心数，但在很多情况下，更大的值也可能带来更快的恢复速度。当然，取值过高会因为频繁争用而导致性能下降。

只有自定义格式和目录格式归档支持此选项。输入必须是常规文件或目录（例如不能是管道或标准输入）。另外，多个作业不能与 --single-transaction 选项一起使用。

列出归档的目录。此操作的输出可用作 -L 选项的输入。注意，如果将 -n 或 -t 等筛选选项与 -l 一起使用，它们会限制所列出的项目。

只恢复 list-file 中列出的归档元素，并按照它们在文件中出现的顺序恢复。注意，如果将 -n 或 -t 等筛选选项与 -L 一起使用，它们会进一步限制所恢复的项目。

list-file 通常是通过编辑先前 -l 操作的输出来创建的。可以移动或删除行，也可以通过在行首放置分号（;）将其注释掉。示例见下文。

仅恢复位于指定模式中的对象。可以通过多次指定 -n 来指定多个模式。这可以与 -t 选项结合使用，只恢复特定表。

不恢复位于指定模式中的对象。可以通过多次指定 -N 来排除多个模式。

当对同一模式名同时给出 -n 和 -N 时，-N 优先，该模式会被排除。

不输出用于设置对象所有权以匹配原始数据库的命令。默认情况下，pg_restore 会发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句，为所创建的模式元素设置所有权。除非对数据库的初始连接由超级用户发起（或者由脚本中所有对象的同一所有者发起），否则这些语句会失败。使用 -O 时，初始连接可以使用任意用户名，并且该用户将拥有所有创建的对象。

仅恢复指定函数。请务必按转储文件目录中显示的形式准确拼写函数名和参数。可以通过多次指定 -P 来恢复多个函数。

这个选项已经过时，但仍然被接受以保持向后兼容性。

仅恢复模式（数据定义），不恢复数据，前提是归档中存在模式条目。

此选项不能与 --data-only 或 --statistics-only 一起使用。它类似于指定 --section=pre-data --section=post-data --no-statistics，但由于历史原因并不完全相同。

（不要把它与 --schema 选项混淆，后者中的“schema”一词含义不同。）

指定在禁用触发器时要使用的超级用户用户名。仅当使用 --disable-triggers 时才相关。

仅恢复指定表的定义和/或数据。这里的“表”包括视图、物化视图、序列和外部表。可以通过多次指定 -t 来选择多个表。此选项可以与 -n 选项结合使用，以指定特定模式中的表。

仅恢复指定名称的触发器。可以通过多次指定 -T 来恢复多个触发器。

指定详细模式。这会使 pg_restore 将详细的对象注释和开始/停止时间输出到输出文件，并将进度消息输出到标准错误。重复此选项会使标准错误中出现额外的调试级消息。

打印 pg_restore 的版本并退出。

不恢复访问权限（grant/revoke 命令）。

将恢复作为单个事务执行（也就是把发出的命令包裹在 BEGIN/COMMIT 中）。这可确保要么所有命令都成功完成，要么不应用任何更改。此选项隐含 --exit-on-error。

此选项仅在执行不包含模式的恢复时才相关。它会指示 pg_restore 在恢复数据期间发出命令，临时禁用目标表上的触发器。如果你不希望在恢复数据期间触发表上的引用完整性检查或其他触发器，请使用此选项。

目前，为 --disable-triggers 发出的命令必须以超级用户身份执行。因此，你还应通过 -S 指定超级用户用户名，或者更好的是，直接以 PostgreSQL 超级用户身份运行 pg_restore。

此选项仅在恢复启用了行安全性的表内容时才相关。默认情况下，pg_restore 会将row_security设置为 off，以确保所有数据都能恢复到表中。如果用户没有足够的权限绕过行安全性，就会抛出错误。此参数会指示 pg_restore 改为将row_security设置为 on，从而允许用户尝试在启用行安全性的情况下恢复表内容。如果用户无权将转储中的行插入该表，这仍然可能失败。

请注意，此选项当前还要求转储采用 INSERT 格式，因为 COPY FROM 不支持行安全性。

指定一个文件名，从中读取恢复时要排除或包含的对象匹配模式。这些模式按照与下列选项相同的规则解释：-n/--schema 用于包含某个模式中的对象，-N/--exclude-schema 用于排除某个模式中的对象，-P/--function 用于恢复指定函数，-I/--index 用于恢复指定索引，-t/--table 用于恢复指定表，以及 -T/--trigger 用于恢复触发器。要从 STDIN 读取，请使用 - 作为文件名。--filter 选项可以与上面列出的包含或排除对象的选项结合使用，也可以为了指定多个过滤文件而多次给出。

该文件每行列出一个对象匹配模式，格式如下：

{ include | exclude } { function | index | schema | table | trigger } PATTERN

第一个关键字指定是包含还是排除与模式匹配的对象。第二个关键字指定要用该模式过滤的对象类型：

以 # 开头的行被视为注释并忽略。注释也可以放在对象匹配模式行之后。空白行同样会被忽略。有关如何在匹配模式中加引号，请参见模式。

使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean，否则此选项无效。

不输出用于恢复注释的命令，即使归档中包含注释。

不输出用于恢复数据的命令，即使归档中包含数据。

默认情况下，即使表的创建命令失败（例如因为表已经存在），表数据仍然会被恢复。使用此选项时，这类表的数据会被跳过。如果目标数据库已经包含所需的表内容，这种行为会很有用。例如，PostgreSQL 扩展（如 PostGIS）的辅助表可能已经装载到目标数据库中；指定此选项可以防止向这些表装载重复或过时的数据。

此选项仅在直接恢复到数据库时有效，而在生成 SQL 脚本输出时无效。

不输出用于恢复行安全性策略的命令，即使归档中包含它们。

不输出用于恢复发布的命令，即使归档中包含它们。

不输出用于恢复模式（数据定义）的命令，即使归档中包含它们。

不输出用于恢复安全标签的命令，即使归档中包含它们。

不输出用于恢复统计信息的命令，即使归档中包含它们。

不输出用于恢复订阅的命令，即使归档中包含它们。

不输出用于选择表访问方法的命令。使用此选项时，所有对象在恢复时都会使用当时默认的表访问方法创建。

不输出用于选择表空间的命令。使用此选项时，所有对象在恢复时都会创建在当时默认的表空间中。

在转储输出中使用提供的字符串作为 psql \restrict 键。这只能用于 SQL 脚本输出，也就是使用 --file 选项时。如果未指定该键，pg_restore 会按需随机生成一个。键只能包含字母数字字符。

此选项主要用于测试以及其他需要可重复输出的场景（例如比较转储文件）。一般不建议使用它，因为若恶意服务器事先知道该键，可能能够注入任意代码，并在运行 psql 处理转储输出的机器上执行。

仅恢复指定部分。部分名称可以是 pre-data、data 或 post-data。可以多次指定此选项来选择多个部分。默认是恢复所有部分。

数据部分包含实际的表数据以及大对象定义。post-data 部分由索引、触发器、规则以及除已验证检查约束之外的约束定义组成。pre-data 部分则由所有其他数据定义项组成。

如果归档中包含统计信息，则输出用于恢复统计信息的命令。这是默认行为。

仅恢复统计信息，不恢复模式（数据定义）或数据。

要求每个模式限定符（-n/--schema）和表限定符（-t/--table）至少匹配待恢复文件中的一个模式/表。

将恢复作为一系列事务执行，每个事务最多处理 N 个数据库对象。此选项隐含 --exit-on-error。

--transaction-size 在默认行为（每条 SQL 命令一个事务）与 -1/--single-transaction（所有恢复对象共用一个事务）之间提供了一个折中选择。虽然 --single-transaction 的额外开销最小，但对于大型数据库来说可能并不现实，因为该事务会在每个恢复对象上获取锁，从而可能耗尽服务器的锁表空间。使用 --transaction-size 并将大小设为几千个对象，可以在限制所需锁表空间的同时，获得几乎相同的性能收益。

输出符合 SQL 标准的 SET SESSION AUTHORIZATION 命令，而不是使用 ALTER OWNER 命令来确定对象所有权。这样会使转储结果更符合标准，但根据转储中对象的历史，可能无法正确恢复。

显示关于 pg_restore 命令行参数的帮助信息，并退出。

指定服务器所在机器的主机名。如果值以斜杠开头，则被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果已设置），否则尝试使用 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认值取自 PGPORT 环境变量（如果已设置），否则使用编译时默认值。

用于连接的用户名。

绝不发出密码提示。如果服务器要求密码认证，而又无法通过 .pgpass 文件等其他方式获得密码，则连接尝试将失败。在没有用户在场输入密码的批处理作业和脚本中，此选项很有用。

强制 pg_restore 在连接数据库之前提示输入密码。

此选项实际上并非必需，因为如果服务器要求密码认证，pg_restore 会自动提示输入密码。不过，pg_restore 会浪费一次连接尝试来发现服务器需要密码。在某些情况下，键入 -W 以避免这一次额外的连接尝试是值得的。

指定执行恢复时要使用的角色名。此选项会使 pg_restore 在连接数据库后发出 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少 pg_restore 所需的权限，但可以切换到具有所需权限的角色时，此选项会很有用。有些安装环境禁止直接以超级用户登录，而使用此选项可以在不违反该策略的情况下执行恢复。

默认连接参数

指定诊断消息是否使用颜色。可选值为 always、auto和 never。