指定要转储的数据库的名称。如果未指定，则使用环境变量 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 时指定该选项。

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

如果通过 pg_extension_config_dump 注册了任何配置关系，则当其扩展通过 --extension 指定时，该关系将包含在转储中。

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

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

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

通过同时转储 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 命令使用的相同规则解释为模式（请参阅 模式），因此还可以通过在模式中编写通配符来选择多个模式。使用通配符时，请小心引用模式（如果需要），以防止 shell 扩展通配符；请参阅下面的 示例。

不要转储与 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 选项混淆，后者以不同的含义使用单词 “模式”。）

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

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

仅转储与 pattern 匹配的名称的表。可以通过编写多个 -t 开关来选择多个表。pattern 参数根据 psql 的 \d 命令所使用的相同规则解释为一个模式（请参阅 模式），因此还可以通过在模式中编写通配符来选择多个表。使用通配符时，请小心引用模式，以防止 shell 扩展通配符；请参阅下面的 示例。

除了表之外，此选项还可用于转储匹配视图、物化视图、外部表和序列的定义。它不会转储视图或物化视图的内容，并且只有在使用 --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 不支持行安全性。

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

不转储与 pattern 匹配的任何表的数据。该模式的解释遵循与 -t 相同的规则。可以多次给出 --exclude-table-data 以排除与任何多个模式匹配的表。即使您不需要表中的数据，此选项在您需要特定表的定义时也很有用。

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

这与 --exclude-table-data 选项相同，除了它还排除与 pattern 匹配的表的所有分区或继承子表的数据。

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

使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会禁止报告可能出现的 “不存在” 错误。此选项仅在同时指定 --clean 时才有效。

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

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

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

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

不转储注释。

不转储发布。

不转储安全标签。

不转储订阅。

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

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

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

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

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

不输出用于设置TOAST压缩方法的命令。使用此选项，所有列都将使用默认压缩设置还原。

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

将ON CONFLICT DO NOTHING添加到INSERT命令。除非还指定了--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.94）。

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

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

要求每个扩展 (-e/--extension)、架构 (-n/--schema) 和表 (-t/--table) 模式至少与要转储的数据库中的一个扩展/架构/表匹配。请注意，如果扩展/架构/表模式均未找到匹配项，则即使没有 --strict-names，pg_dump 也会生成错误。

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

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

输出 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 角色名 命令。当经过身份验证的用户（由 -U 指定）不具备 pg_dump 所需的权限，但可以切换到具有所需权限的角色时，此选项非常有用。一些安装程序有禁止直接以超级用户身份登录的策略，而使用此选项可以在不违反策略的情况下进行转储。

默认连接参数。

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