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

在重新创建所有转储的数据库、角色和表空间之前，发出 SQL 命令以 DROP 它们。在还原操作将覆盖现有集群时，此选项非常有用。如果目标集群中不存在任何对象，则在还原期间将报告可忽略的错误消息，除非还指定了 --if-exists。

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

将输出发送到指定的文件。如果省略此项，则使用标准输出。

仅转储全局对象（角色和表空间），不转储数据库。

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

仅转储角色，不转储数据库或表空间。

仅转储对象定义（架构），不转储数据。

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

仅转储表空间，不转储数据库或角色。

指定详细模式。这将导致 pg_dumpall 向转储文件输出开始/停止时间，并向标准错误输出进度消息。重复此选项会导致标准错误上出现其他调试级别消息。此选项也会传递给 pg_dump。

打印 pg_dumpall 版本并退出。

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

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

以带有显式列名的 INSERT 命令转储数据（INSERT INTO table (column, ...) VALUES ...）。这会使恢复非常缓慢；它主要用于生成可加载到非 PostgreSQL 数据库中的转储。

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

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

目前，为 --disable-triggers 发出的命令必须作为超级用户执行。因此，您还应该使用 -S 指定一个超级用户名称，或者最好小心地以超级用户身份启动结果脚本。

不转储名称与 pattern 匹配的数据库。可以通过编写多个 --exclude-database 开关来排除多个模式。 pattern 参数根据 psql 的 \d 命令使用的相同规则解释为模式（请参见 模式），因此还可以通过在模式中编写通配符来排除多个数据库。在使用通配符时，请小心引用模式（如果需要），以防止 shell 通配符展开。

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

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

以 INSERT 命令（而不是 COPY）转储数据。这会使恢复非常缓慢；它主要用于生成可加载到非 PostgreSQL 数据库中的转储。请注意，如果您重新排列了列顺序，则恢复可能会完全失败。 --column-inserts 选项更安全，尽管速度更慢。

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

不要无限期地等待在转储开始时获取共享表锁。相反，如果无法在指定的 timeout 内锁定表，则失败。超时可以使用 SET statement_timeout 接受的任何格式指定。

不要转储注释。

不要转储发布。

不要转储角色的密码。还原时，角色将具有空密码，并且密码验证在设置密码之前将始终失败。由于在指定此选项时不需要密码值，因此从目录视图 pg_roles 而不是 pg_authid 读取角色信息。因此，如果某些安全策略限制了对 pg_authid 的访问，此选项也有帮助。

不要转储安全标签。

不要转储订阅。

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

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

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

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

不要转储未记录表的表内容。此选项不影响是否转储表定义（模式）；它仅禁止转储表数据。

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

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

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

输出 SQL 标准SET SESSION AUTHORIZATION命令，而不是ALTER OWNER命令来确定对象所有权。这使得转储更符合标准，但根据转储中对象的记录，可能无法正确还原。

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

指定用于连接到服务器的参数，作为连接字符串；这些参数将覆盖任何冲突的命令行选项。

该选项称为 --dbname，与其他客户端应用程序保持一致，但由于 pg_dumpall 需要连接到多个数据库，因此连接字符串中的数据库名称将被忽略。使用 -l 选项指定用于初始连接的数据库名称，该数据库将转储全局对象并发现应该转储的哪些其他数据库。

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

指定要连接到的数据库的名称，以转储全局对象并发现应该转储的哪些其他数据库。如果未指定，将使用 postgres 数据库，如果该数据库不存在，将使用 template1。

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

以其身份连接的用户名。

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

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

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

请注意，对于要转储的每个数据库，都会再次出现密码提示。通常，设置 ~/.pgpass 文件比依赖手动输入密码更好。

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

默认连接参数

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