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

仅转储数据，不转储模式（数据定义）。转储表数据、大对象和序列值。

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

在转储中包含大对象。这是默认行为，除非指定 --schema、--table 或 --schema-only。因此，-b 开关仅用于将大对象添加到已请求特定模式或表的转储中。请注意，大对象被视为数据，因此在使用 --data-only 时会被包含，但在使用 --schema-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 展开通配符。

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

以指定的字符集编码创建转储。默认情况下，转储以数据库编码创建。（另一种获得相同结果的方法是将 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 使用多个数据库连接；它使用主进程连接到数据库一次，并且为每个工作作业再次连接。如果没有同步快照功能，不同的工作作业不能保证在每个连接中看到相同的数据，这会导致不一致的备份。

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

不要转储任何与 pattern 匹配的模式。模式根据与 -n 相同的规则进行解释。 -N 可以多次给出，以排除与多个模式匹配的模式。

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

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

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

此选项已过时，但为了向后兼容性而仍然接受。

仅转储对象定义（模式），不转储数据。

此选项是 --data-only 的反义词。它类似于，但由于历史原因不完全等同于，指定 --section=pre-data --section=post-data。

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

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

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

仅转储名称与 pattern 匹配的表。可以通过编写多个 -t 开关来选择多个表。 pattern 参数被解释为一个模式，遵循与 psql 的 \d 命令使用的相同规则（见 Patterns），因此也可以通过在模式中写入通配符来选择多个表。使用通配符时，请注意在需要时引用模式以防止 shell 展开通配符；见 Examples 如下。

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

当使用 -t 时，-n 和 -N 开关无效，因为通过 -t 选择的表将被转储，而不管这些开关如何，并且非表对象将不会被转储。

不要转储任何与 pattern 匹配的表。模式根据与 -t 相同的规则进行解释。 -T 可以多次给出，以排除与多个模式匹配的表。

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

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

打印 pg_dump 版本并退出。

防止转储访问权限（授予/撤销命令）。

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

如果未指定压缩级别，将使用默认压缩级别。如果仅指定一个级别而没有提及算法，则如果级别大于 0，将使用 gzip 压缩，如果级别为 0，则不使用压缩。

对于自定义和目录存档格式，这指定了对单个表数据段的压缩，默认是使用 gzip 以中等级别进行压缩。对于纯文本输出，设置非零压缩级别会导致整个输出文件被压缩，就好像它被送入 gzip、lz4 或 zstd 一样；但默认是不压缩。使用 zstd 压缩时，long 模式可能会提高压缩率，但代价是增加内存使用量。

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

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

将数据转储为带有显式列名的 INSERT 命令（INSERT INTO table (column, ...) VALUES ...）。这会使恢复非常缓慢；它主要用于创建可加载到非 PostgreSQL 数据库中的转储。恢复过程中的任何错误只会导致有问题的 INSERT 命令中的一部分行丢失，而不是整个表内容。

此选项禁用对函数体使用美元引用，并强制使用 SQL 标准字符串语法引用它们。

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

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

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

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

请注意，如果您目前使用此选项，您可能还需要将转储设置为 INSERT 格式，因为恢复过程中的 COPY FROM 不支持行安全性。

不要转储与 pattern 匹配的任何扩展。该模式根据与 -e 相同的规则进行解释。可以多次给出 --exclude-extension 来排除与多个模式匹配的扩展。

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

这与 -T/--exclude-table 选项相同，只是它还排除了与 pattern 匹配的表的任何分区或继承子表。

不要转储与 pattern 匹配的任何表的數據。该模式根据与 -t 相同的规则进行解释。可以多次给出 --exclude-table-data 来排除与多个模式匹配的表。当您需要特定表的定义，但不需要其中的數據时，此选项很有用。

要排除数据库中所有表的數據，请参阅 --schema-only。

这与 --exclude-table-data 选项相同，只是它还排除了与 pattern 匹配的表的任何分区或继承子表的數據。

在转储浮点數據时，使用指定的 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

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

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

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

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

转储任何与 foreignserver 模式匹配的外国服务器的外国表的數據。可以通过编写多个 --include-foreign-data 开关来选择多个外国服务器。此外，foreignserver 参数根据 psql 的 \d 命令所使用的相同规则进行解释（请参阅 Patterns），因此可以通过在模式中编写通配符来选择多个外国服务器。使用通配符时，请注意在需要时引用模式以防止 shell 展开通配符；请参阅下面的 Examples。唯一的例外是空模式不允许。

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

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

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

不要转储注释。

不要转储发布。

不要转储安全标签。

不要转储订阅。

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

不要输出命令来选择表访问方法。使用此选项，所有对象将在恢复过程中创建为默认的表访问方法。

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

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

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

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

不要转储未记录表的內容和序列。此选项不会影响是否转储表和序列定义（模式）；它只会抑制转储表和序列數據。未记录表和序列中的數據在从备用服务器转储时始终被排除。

在INSERT命令中添加ON CONFLICT DO NOTHING。除非同时指定了--inserts、--column-inserts或--rows-per-insert，否则此选项无效。

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

将数据转储为 INSERT 命令（而不是 COPY）。控制每个 INSERT 命令的最大行数。指定的数值必须大于零。还原期间的任何错误只会导致有问题的INSERT的一部分行丢失，而不是整个表的全部内容。

只转储指定的段。段名称可以是pre-data、data或post-data。此选项可以指定多次以选择多个段。默认情况下，转储所有段。

数据段包含实际的表数据、大对象内容和序列值。数据后的项目包括索引、触发器、规则和约束的定义，但不包括已验证的检查约束。数据前的项目包括所有其他数据定义项目。

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

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

如果在启动 pg_dump 时没有活动读写事务，此选项将没有区别。如果存在活动读写事务，转储的开始可能会延迟不确定的时间。运行后，有无开关的性能相同。

在转储数据库时使用指定的同步快照（有关更多详细信息，请参见表 9.98）。

当需要将转储与逻辑复制槽（请参见第 47 章）或并发会话同步时，此选项很有用。

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

要求每个扩展（-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选项相同，只是它还包括与pattern匹配的表的任何分区或继承子表。

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

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

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

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

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

要连接的用户名称。

从不发出密码提示。如果服务器需要密码身份验证，而密码无法通过其他方式（例如.pgpass文件）获得，则连接尝试将失败。此选项在没有用户参与输入密码的批处理作业和脚本中很有用。

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

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

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

默认连接参数。

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