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

只恢复数据，而不恢复模式（数据定义）或统计信息。如果表数据、大对象和序列值存在于归档中，则会恢复它们。

此选项与指定 --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 可以是一个 connection string。如果是这样，连接字符串参数将覆盖任何与之冲突的命令行选项。

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

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

指定归档的格式。没有必要指定格式，因为 pg_restore 会自动确定格式。如果指定，则可以是下列格式之一：

只恢复指定索引的定义。可以用多个 -I 开关指定多个索引。

并发运行 pg_restore 中最耗时的步骤（即那些加载数据、创建索引或创建约束的步骤），最多使用 number-of-jobs 个并发会话。此选项可以显著减少将一个大型数据库恢复到运行在多处理器机器上的服务器所需的时间。当输出脚本而不是直接连接到数据库服务器时，此选项会被忽略。

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

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

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

列出归档的目录（table of contents）。此操作的输出可以用作 -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 选项混淆，后者以不同的含义使用 “模式” 一词。）

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

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

只恢复指定的触发器。可以用多个 -T 开关指定多个触发器。

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

打印 pg_restore 的版本并退出。

阻止恢复访问特权（grant/revoke 命令）。

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

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

目前，为 --disable-triggers 发出的命令必须以超级用户身份执行。因此你还应该用 -S 指定一个超级用户名，或者更可取的是，让 pg_restore 以一个 PostgreSQL 超级用户的身份运行。

此选项仅在恢复一个具有行安全性的表的内容时才相关。默认情况下，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

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

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

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

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

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

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

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

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

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

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

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

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

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

不输出选择表访问方法的命令。使用此选项时，所有对象都会使用恢复期间作为默认值的表访问方法来创建。

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

将所提供的字符串用作转储输出中的 psql \restrict 密钥。此选项只能为 SQL 脚本输出指定，也就是说，只能在使用 --file 选项时指定。如果没有指定 restrict 密钥，pg_restore 将在需要时生成一个随机密钥。密钥只能包含字母和数字。

此选项主要用于测试目的以及需要可重复输出的其他场景（例如比较转储文件）。不建议在一般用途中使用它，因为预先知道该密钥的恶意服务器也许能够注入任意代码，这些代码将在使用该转储输出运行 psql 的机器上被执行。

只恢复指定的节。节名可以是 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。