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

仅恢复数据，而不恢复模式（数据定义）。如果归档文件中存在，则恢复表数据、大对象和序列值。

此选项类似于（但由于历史原因与之不完全相同）指定 --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。

指定要从中读取模式的文件名，以从恢复中排除或包含对象。这些模式根据与 -n/--schema 相同的规则进行解释，以包含模式中的对象，-N/--exclude-schema 以排除模式中的对象，-P/--function 以恢复命名的函数，-I/--index 以恢复命名的索引，-t/--table 以恢复命名的表或 -T/--trigger 以恢复触发器。要从 STDIN 读取，请使用 - 作为文件名。 --filter 选项可以与上面列出的选项结合使用以包含或排除对象，并且可以多次指定以用于多个过滤器文件。

该文件每行列出一个数据库模式，格式如下

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

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

以 # 开头的行被视为注释并被忽略。注释也可以放在对象模式行的后面。空行也被忽略。有关如何在模式中执行引用的方法，请参见 模式。

指定归档文件的格式。无需指定格式，因为 pg_restore 将自动确定格式。如果指定，则可以是以下之一

仅恢复命名索引的定义。可以使用多个 -I 开关指定多个索引。

并发运行 pg_restore 最耗时的步骤——加载数据、创建索引或创建约束的步骤，使用多达 作业数 个并发会话。此选项可以大大减少将大型数据库恢复到运行在多处理器机器上的服务器所需的时间。在发出脚本而不是直接连接到数据库服务器时，将忽略此选项。

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

此选项的最佳值取决于服务器、客户端和网络的硬件设置。因素包括 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选项混淆，该选项以不同的含义使用“schema”一词。）

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

仅还原命名表的定义和/或数据。为此，“table”包括视图、物化视图、序列和外部表。可以通过编写多个-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不支持行安全性。

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

即使归档文件包含注释，也不输出还原注释的命令。

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

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

即使归档文件包含发布，也不输出还原发布的命令。

即使归档文件包含安全标签，也不输出还原安全标签的命令。

即使归档文件包含订阅，也不输出还原订阅的命令。

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

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

仅还原命名的部分。部分名称可以是pre-data、data或post-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。