指定要还原的存档文件（或目录，对于目录格式存档）的位置。如果未指定，则使用标准输入。

仅还原数据，而不还原架构（数据定义）。如果存档中存在表数据、大对象和序列值，则还原它们。

此选项类似于指定 --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 的反向选项。它类似于指定 --section=pre-data --section=post-data，但由于历史原因，两者并不完全相同。

（不要将此选项与 --schema 选项混淆，后者以不同的含义使用单词 “架构”。）

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

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

仅还原指定名称的触发器。可以使用多个 -T 开关指定多个触发器。

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

打印 pg_restore 版本并退出。

禁止还原访问权限（授予/撤销命令）。

将还原作为单个事务执行（即，用 BEGIN/COMMIT 将发出的命令包装起来）。这可确保所有命令都成功完成，或不应用任何更改。此选项暗示 --exit-on-error。

此选项仅在执行仅数据还原时相关。它指示 pg_restore 执行命令以在还原数据时暂时禁用目标表上的触发器。如果您在表上具有引用完整性检查或其他触发器，并且您不希望在数据还原期间调用这些触发器，请使用此选项。

目前，为 --disable-triggers 发出的命令必须作为超级用户执行。因此，您还应该使用 -S 指定超级用户名，或者最好以 PostgreSQL 超级用户的身份运行 pg_restore。

此选项仅在还原具有行安全性的表的表内容时相关。默认情况下，pg_restore 会将 row_security 设置为关闭，以确保所有数据都还原到表中。如果用户没有足够的权限绕过行安全性，则会引发错误。此参数指示 pg_restore 将 row_security 设置为打开，允许用户尝试在启用行安全性的情况下还原表的内容。如果用户没有从转储中向表中插入行的权限，这可能仍然会失败。

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

使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会禁止可能报告的 “不存在” 错误。除非也指定 --clean，否则此选项无效。

不要输出用于还原注释的命令，即使存档包含这些注释。

默认情况下，即使表的创建命令失败（例如，因为它已存在），也会还原表数据。使用此选项，将跳过此类表的的数据。如果目标数据库已包含所需的表内容，此行为非常有用。例如，PostgreSQL 扩展（如 PostGIS）的辅助表可能已加载到目标数据库中；指定此选项可防止将重复或过时的数据加载到其中。

此选项仅在直接还原到数据库中时有效，而不是在生成 SQL 脚本输出时有效。

不要输出用于还原发布的命令，即使存档包含这些发布。

不要输出用于还原安全标签的命令，即使存档包含这些安全标签。

不要输出用于还原订阅的命令，即使存档包含这些订阅。

不要输出用于选择表访问方法的命令。使用此选项，所有对象都将使用还原期间的默认访问方法创建。

不要输出用于选择表空间的命令。使用此选项，所有对象都将在还原期间的默认表空间中创建。

仅还原命名的部分。部分名称可以是 pre-data、data 或 post-data。可以多次指定此选项以选择多个部分。默认情况下，还原所有部分。

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

要求每个架构 (-n/--schema) 和表 (-t/--table) 限定符至少与备份文件中的一个架构/表匹配。

输出 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。