指定要转储的数据库名称。如果未指定，则使用环境变量 PGDATABASE。如果该变量未设置，则使用连接指定的用户名称。

仅转储数据，而不转储模式（数据定义）或统计信息。转储表数据、大对象和序列值。

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

在转储中包含大对象。这是默认行为，除非指定了 --schema、--table、--schema-only、--statistics-only 或 --no-data。因此，-b 开关仅在请求了特定模式或表时用于将大对象添加到转储中。请注意，大对象被视为数据，因此在使用 --data-only 时会包含它们，但在使用 --schema-only 或 --statistics-only 时不会。

排除转储中的大对象。

当同时给出 -b 和 -B 时，行为是在转储数据时输出大对象，请参阅 -b 的文档。

在输出创建它们的命令之前，输出用于 DROP 所有转储的数据库对象的命令。当恢复时需要覆盖现有数据库时，此选项非常有用。如果目标数据库中不存在任何对象，则在恢复期间将报告可忽略的错误消息，除非还指定了 --if-exists。

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

在输出开始时添加一个创建数据库本身的命令，并重新连接到已创建的数据库。（使用此形式的脚本，在运行脚本之前连接到目标安装中的哪个数据库并不重要。）如果还指定了 --clean，则脚本将先删除目标数据库，然后再重新创建它，之后再重新连接。

使用 --create 时，输出还包括数据库的注释（如果存在），以及特定于此数据库的任何配置变量设置，即任何提及此数据库的 ALTER DATABASE ... SET ... 和 ALTER ROLE ... IN DATABASE ... SET ... 命令。数据库本身的访问权限也会被转储，除非指定了 --no-acl。

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

仅转储与 模式 匹配的扩展。当未指定此选项时，将转储目标数据库中的所有非系统扩展。可以通过编写多个 -e 开关来选择多个扩展。模式 参数被解释为与 psql 的 \d 命令使用的规则相同的模式（请参阅 模式），因此通过在模式中写入通配符也可以选择多个扩展。使用通配符时，请务必引用模式（如果需要），以防止 shell 扩展通配符。

通过 pg_extension_config_dump 注册的任何配置关系都将包含在转储中，如果其扩展由 --extension 指定。

以指定的字符集编码创建转储。默认情况下，转储以数据库编码创建。（获得相同结果的另一种方法是将 PGCLIENTENCODING 环境变量设置为所需的转储编码。）支持的编码在 第 23.3.1 节 中描述。

将输出发送到指定的文件。对于基于文件的输出格式，可以省略此参数，在这种情况下将使用标准输出。但是，对于目录输出格式，必须提供此参数，在这种情况下，它指定目标目录而不是文件。在这种情况下，目录将由 pg_dump 创建，并且必须预先不存在。

选择输出的格式。格式 可以是以下之一

通过同时转储 njobs 个表来并行运行转储。此选项可以减少转储所需的时间，但也会增加数据库服务器的负载。只能将此选项与目录输出格式一起使用，因为这是唯一允许多个进程同时写入其数据的输出格式。

pg_dump 将打开 njobs + 1 个到数据库的连接，因此请确保您的 max_connections 设置足够高，可以容纳所有连接。

在并行转储运行时请求数据库对象的独占锁可能会导致转储失败。原因是 pg_dump 领导者进程请求要转储的对象上的共享锁（ACCESS SHARE），以确保在转储运行时没有人删除它们。如果另一个客户端随后请求表的独占锁，该锁将不会被授予，而是排队等待领导者进程的共享锁被释放。因此，对表的任何其他访问都将不会被授予，并将排队在独占锁请求之后。这包括尝试转储表的辅助进程。在没有任何预防措施的情况下，这会是一个经典的死锁情况。为了检测此冲突，pg_dump 辅助进程请求另一个共享锁，使用 NOWAIT 选项。如果辅助进程未能获得此共享锁，则意味着此时必须有人请求了独占锁，并且无法继续转储，因此 pg_dump 别无选择，只能中止转储。

要执行并行转储，数据库服务器需要支持同步快照，这是在 PostgreSQL 9.2 的主服务器和 10 的备用服务器中引入的功能。通过此功能，数据库客户端可以确保它们看到相同的数据集，即使它们使用不同的连接。pg_dump -j 使用多个数据库连接；它使用领导者进程连接一次数据库，并为每个辅助作业连接一次。如果没有同步快照功能，则不能保证不同的辅助作业会在每个连接中看到相同的数据，这可能导致不一致的备份。

仅转储与 模式 匹配的模式；这将同时选择模式本身及其包含的所有对象。当未指定此选项时，将转储目标数据库中的所有非系统模式。可以通过编写多个 -n 开关来选择多个模式。模式 参数被解释为与 psql 的 \d 命令使用的规则相同的模式（请参阅 模式），因此通过在模式中写入通配符也可以选择多个模式。使用通配符时，请务必引用模式（如果需要），以防止 shell 扩展通配符；请参阅下面的 示例。

不要转储与 模式 匹配的任何模式。模式的解释方式与 -n 相同。-N 可以多次给出，以排除与多个模式中的任何一个匹配的模式。

当同时给出 -n 和 -N 时，行为是仅转储至少匹配一个 -n 开关但不匹配任何 -N 开关的模式。如果 -N 出现在没有 -n 的情况下，那么与 -N 匹配的模式将从正常的转储中排除。

不要输出命令来设置对象的所有权以匹配原始数据库。默认情况下，pg_dump 会发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句来设置创建的数据库对象的所有权。除非脚本由超级用户（或拥有脚本中所有对象的同一用户）启动，否则运行脚本时这些语句将失败。要创建一个任何用户都可以还原的脚本，但会给予该用户所有对象的权限，请指定 -O。

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

此选项已过时，但仍接受以向后兼容。

仅转储对象定义（模式），不转储数据或统计信息。

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

（不要将其与 --schema 选项混淆，后者在不同含义上使用了“schema”一词。）

要仅排除数据库中一部分表的表数据，请参阅 --exclude-table-data。

指定在使用禁用触发器时要使用的超级用户用户名。这仅在使用了 --disable-triggers 时才相关。（通常，最好省略此项，而是以超级用户身份启动生成的脚本。）

仅转储名称与 模式 匹配的表。可以通过编写多个 -t 开关来选择多个表。模式 参数被解释为与 psql 的 \d 命令使用的规则相同的模式（请参阅 模式），因此通过在模式中写入通配符也可以选择多个表。使用通配符时，请务必引用模式（如果需要），以防止 shell 扩展通配符；请参阅下面的 示例。

除了表之外，此选项还可用于转储匹配的视图、物化视图、外部表和序列的定义。它不会转储视图或物化视图的内容，并且只有在使用 --include-foreign-data 指定了相应的外部服务器时，才会转储外部表的内容。

当使用 -t 时，-n 和 -N 开关无效，因为无论这些开关如何，都会转储由 -t 选择的表，而不会转储非表对象。

不要转储与 模式 匹配的任何表。模式的解释方式与 -t 相同。-T 可以多次给出，以排除与多个模式中的任何一个匹配的表。

当同时给出 -t 和 -T 时，行为是仅转储至少匹配一个 -t 开关但不匹配任何 -T 开关的表。如果 -T 出现在没有 -t 的情况下，那么与 -T 匹配的表将从正常的转储中排除。

指定详细模式。这将导致 pg_dump 将详细的对象注释和开始/停止时间输出到转储文件，并将进度消息输出到标准错误流。重复该选项将导致额外的调试级别消息出现在标准错误流上。

打印 pg_dump 版本并退出。

阻止转储访问权限（GRANT/REVOKE 命令）。

指定要使用的压缩方法和/或压缩级别。压缩方法可以设置为 gzip、lz4、zstd 或 none（无压缩）。可以选择性地指定压缩详细信息字符串。如果详细信息字符串是整数，则指定压缩级别。否则，它应该是一个由逗号分隔的项目列表，每个项目形式为 关键字 或 关键字=值。目前，支持的关键字是 level 和 long。

如果未指定压缩级别，则将使用默认压缩级别。如果仅指定级别而未提及算法，则当级别大于 0 时将使用 gzip 压缩，当级别为 0 时则不进行压缩。

对于自定义和目录归档格式，此选项指定对各个表数据段进行压缩，默认使用 gzip 以中等级别进行压缩。对于纯文本输出，设置非零压缩级别将导致整个输出文件被压缩，如同通过 gzip、lz4 或 zstd 进行过管道传输一样；但默认情况下不进行压缩。使用 zstd 压缩时，long 模式可能会提高压缩率，但会增加内存使用。

tar 归档格式目前根本不支持压缩。

此选项供就地升级实用程序使用。不推荐或不支持将其用于其他目的。该选项的行为可能在未来的版本中更改，恕不另行通知。

以带有显式列名的 INSERT 命令（INSERT INTO 表 (列, ...) VALUES ...）的形式转储数据。这将使恢复速度非常慢；它主要用于制作可以加载到非 PostgreSQL 数据库中的转储。恢复期间的任何错误只会导致有问题的 INSERT 中的行丢失，而不是整个表内容丢失。

此选项禁用函数体中使用美元引号，并强制使用 SQL 标准字符串语法对其进行引用。

此选项仅在创建包含数据但不包含模式的转储时相关。它指示 pg_dump 在恢复数据期间包含临时禁用目标表上触发器的命令。如果您在表上有参照完整性检查或其他触发器，但不想在数据恢复期间调用它们，请使用此选项。

目前，为 --disable-triggers 发出的命令必须以超级用户身份执行。因此，您还应使用 -S 指定超级用户名，或者最好注意以超级用户身份启动生成的脚本。

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

此选项仅在转储具有行安全策略的表的内容时相关。默认情况下，pg_dump 将 row_security 设置为关闭，以确保从表中转储所有数据。如果用户没有足够的权限绕过行安全策略，则会引发错误。此参数指示 pg_dump 将 row_security 设置为开启，从而允许用户转储他们有权访问的表内容的各个部分。

请注意，如果您使用此选项，您可能还希望转储为 INSERT 格式，因为 COPY FROM 在恢复期间不支持行安全策略。

不要转储与 模式 匹配的任何扩展。模式的解释方式与 -e 相同。--exclude-extension 可以多次给出，以排除与多个模式中的任何一个匹配的扩展。

当同时给出 -e 和 --exclude-extension 时，行为是仅转储至少匹配一个 -e 开关但不匹配任何 --exclude-extension 开关的扩展。如果 --exclude-extension 出现在没有 -e 的情况下，那么与 --exclude-extension 匹配的扩展将从正常的转储中排除。

这与 -T/--exclude-table 选项相同，但它还排除了与 模式 匹配的表及其任何分区或继承的子表。

不要转储与 模式 匹配的任何表的任何数据。模式的解释方式与 -t 相同。--exclude-table-data 可以多次给出，以排除与多个模式中的任何一个匹配的表。此选项对于在需要某个特定表的定义但不需要其中数据时非常有用。

要排除数据库中所有表的 D数据，请参阅 --schema-only 或 --statistics-only。

这与 --exclude-table-data 选项相同，但它还排除了与 模式 匹配的表以及这些表的任何分区或继承的子表的数据。

转储浮点数据时使用指定的 extra_float_digits 值，而不是最大可用精度。常规转储以用于备份目的不应使用此选项。

指定一个文件名，从中读取要包含或排除在转储中的对象的模式。模式的解释方式与相应选项相同：-t/--table、--table-and-children、-T/--exclude-table 和 --exclude-table-and-children 用于表，-n/--schema 和 -N/--exclude-schema 用于模式，--include-foreign-data 用于外部服务器上的数据，--exclude-table-data 和 --exclude-table-data-and-children 用于表数据，以及 -e/--extension 和 --exclude-extension 用于扩展。要从 STDIN 读取，请使用 - 作为文件名。--filter 选项可以与上述用于包含或排除对象的选项结合使用，并且可以多次指定以用于多个过滤器文件。

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

{ include | exclude } { extension | foreign_data | table | table_and_children | table_data | table_data_and_children | schema } PATTERN

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

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

示例文件列在下面的 示例 部分。

使用 DROP ... IF EXISTS 命令来删除 --clean 模式中的对象。这会抑制可能报告的“不存在”错误。此选项仅在也指定了 --clean 时才有效。

转储与 foreignserver 模式匹配的任何外部表的表数据。可以通过编写多个 --include-foreign-data 开关来选择多个外部服务器。此外，foreignserver 参数被解释为与 psql 的 \d 命令使用的规则相同的模式（请参阅 模式），因此通过在模式中写入通配符也可以选择多个外部服务器。使用通配符时，请务必引用模式（如果需要），以防止 shell 扩展通配符；请参阅下面的 示例。唯一例外是禁止空模式。

以 INSERT 命令（而不是 COPY）的形式转储数据。这将使恢复速度非常慢；它主要用于制作可以加载到非 PostgreSQL 数据库中的转储。恢复期间的任何错误只会导致有问题的 INSERT 中的行丢失，而不是整个表内容丢失。请注意，如果重新排列了列顺序，恢复可能会完全失败。--column-inserts 选项对于列顺序更改是安全的，尽管速度会更慢。

在转储表分区的 D数据时，使 COPY 或 INSERT 语句指向包含它的分区层次结构的根，而不是分区本身。这会导致在加载数据时为每一行重新确定适当的分区。当在行不总是落入与原始服务器相同的分区中的服务器上恢复数据时，这可能很有用。例如，如果分区列是 text 类型，并且两个系统对用于对分区列进行排序的排序规则有不同的定义，则可能会发生这种情况。

不要永远等待在转储开始时获取共享表锁。相反，如果在指定的 超时 内无法锁定表，则失败。超时可以是 SET statement_timeout 接受的任何格式。（允许的格式因您从中转储的服务器版本而异，但所有版本都接受以毫秒为单位的整数。）

不要转储 COMMENT 命令。

不要转储 D数据。

不要转储行安全策略。

不要转储发布。

不要转储模式（数据定义）。

不要转储安全标签。

不要转储统计信息。这是默认行为。

不要转储订阅。

默认情况下，pg_dump 将等待所有文件安全地写入磁盘。此选项导致 pg_dump 在不等待的情况下返回，这更快，但意味着后续的操作系统崩溃可能会使转储损坏。通常，此选项对于测试很有用，但不应在从生产安装转储数据时使用。

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

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

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

当发出归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。

不要输出设置TOAST压缩方法的命令。使用此选项，所有列都将以默认压缩设置进行恢复。

不要转储未记录表和序列的内容。此选项对是否转储表和序列定义（模式）没有影响；它仅抑制转储表和序列 D数据。从备用服务器转储时，未记录表和序列中的 D数据始终被排除。

将 ON CONFLICT DO NOTHING 添加到 INSERT 命令。此选项无效，除非还指定了 --inserts、--column-inserts 或 --rows-per-insert。

强制引用所有标识符。当从 PostgreSQL 主版本不同于 pg_dump 的服务器转储数据库时，或者当输出旨在加载到不同主版本的服务器时，建议使用此选项。默认情况下，pg_dump 仅引用其自身主版本中的保留字标识符。这有时会在处理具有略有不同的保留字集的其他版本服务器时导致兼容性问题。使用 --quote-all-identifiers 可以防止此类问题，但代价是转储脚本更难阅读。

使用提供的字符串作为转储输出中的 psql \restrict 键。这只能为纯文本转储指定，即当 --format 设置为 plain 或省略 --format 选项时。如果未指定 restrict 键，pg_dump 将在需要时生成一个随机键。键只能包含字母数字字符。

此选项主要用于测试目的和其他需要可重复输出（例如，比较转储文件）的场景。不建议常规使用，因为带有密钥预知能力的恶意服务器可能能够注入任意代码，这些代码将在运行 psql 并使用转储输出的机器上执行。

以 INSERT 命令（而不是 COPY）的形式转储数据。控制每个 INSERT 命令的最大行数。指定的值必须是大于零的数字。恢复期间的任何错误只会导致有问题的 INSERT 中的行丢失，而不是整个表内容丢失。

仅转储命名节。节名可以是 pre-data、data 或 post-data。可以多次指定此选项以选择多个节。默认是转储所有节。

数据节包含实际表数据、大对象内容、序列值以及表、物化视图和外部表的统计信息。后数据项包括索引、触发器、规则、索引统计信息以及除已验证的检查和非空约束之外的约束的定义。预数据项包括所有其他数据定义项。

在转储中包含序列数据。这是默认行为，除非指定了 --no-data、--schema-only 或 --statistics-only。

使用 serializable 事务进行转储，以确保使用的快照与后续数据库状态一致；但通过等待事务流中的一个点来做到这一点，这样就不会有转储失败或导致其他事务回滚的风险 serialization_failure。有关事务隔离和并发控制的更多信息，请参阅 第 13 章。

此选项对于仅用于灾难恢复的转储没有好处。它可能有助于用于加载数据库副本以进行报告或其他只读负载共享的转储，同时原始数据库继续被更新。没有它，转储可能反映一个与任何事务的串行执行都不一致的状态。例如，如果使用批处理处理技术，一个批次在转储中可能显示为已关闭，但批次中的所有项都没有出现。

如果没有活动读写事务在 pg_dump 启动时激活，此选项将没有区别。如果存在活动读写事务，转储的开始可能会延迟 indeterminate 时间。一旦运行，无论是否有开关，性能都是相同的。

在对数据库进行转储时，使用指定的同步快照（请参阅 表 9.100 以获取更多详细信息）。

此选项对于需要将转储与逻辑复制槽（请参阅 第 47 章）或与并发会话同步非常有用。

在并行转储的情况下，将使用此选项定义的快照名称，而不是获取新快照。

转储统计信息。

仅转储统计信息，而不转储模式（数据定义）或 D数据。转储表、物化视图、外部表和索引的统计信息。

要求每个扩展（-e/--extension）、模式（-n/--schema）和表（-t/--table）模式都能匹配数据库中至少一个要转储的扩展/模式/表。这同样适用于与 --filter 一起使用的过滤器。请注意，如果任何扩展/模式/表模式均未找到匹配项，pg_dump 将生成一个错误，即使没有 --strict-names。

此选项对 --exclude-extension、-N/--exclude-schema、-T/--exclude-table 或 --exclude-table-data 没有影响。未能匹配任何对象的排除模式不被视为错误。

当设置为 fsync（默认值）时，pg_dump --format=directory 将递归打开并同步归档目录中的所有文件。

在 Linux 上，可以使用 syncfs 来要求操作系统同步包含归档目录的整个文件系统。有关使用 syncfs 时需要注意的注意事项，请参阅 recovery_init_sync_method。

当使用 --no-sync 或 --format 未设置为 directory 时，此选项无效。

这与 -t/--table 选项相同，但它还包括与 模式 匹配的表及其任何分区或继承的子表。

输出 SQL 标准 SET SESSION AUTHORIZATION 命令，而不是 ALTER OWNER 命令来确定对象所有权。这使得转储更符合标准，但根据转储对象历史，可能无法正确恢复。此外，使用 SET SESSION AUTHORIZATION 的转储肯定需要超级用户权限才能正确恢复，而 ALTER OWNER 需要较低的权限。

显示有关 pg_dump 命令行参数的帮助，然后退出。

指定要连接的数据库名称。这等同于在命令行上将 数据库名 指定为第一个非选项参数。数据库名 可以是 连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。

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

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

要连接的用户。:

绝不发出密码提示。如果服务器需要密码身份验证且密码不可用（例如通过 .pgpass 文件），则连接尝试将失败。此选项在没有用户在场输入密码的批处理作业和脚本中很有用。

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

此选项永远不是必需的，因为如果服务器要求密码认证，pg_dump 会自动提示输入密码。但是，pg_dump 会浪费一次连接尝试来确定服务器需要密码。在某些情况下，键入 -W 以避免额外的连接尝试是值得的。

指定一个角色名，用于创建转储。此选项会导致 pg_dump 在连接到数据库后发出 SET ROLE 角色名 命令。当认证用户（由 -U 指定）缺乏 pg_dump 所需的权限，但可以切换到具有所需权限的角色时，此选项很有用。一些安装有禁止直接以超级用户身份登录的策略，使用此选项可以在不违反策略的情况下进行转储。

默认连接参数。

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