pg_dump

将要转储的数据库名。如果没有声明这个参数，那么使用环境变量PGDATABASE。 如果那个环境变量也没声明，那么使用发起连接的用户名。

只输出数据，不输出模式(数据定义)。转储表数据、大对象和序列值。

这个选项类似于声明--section=data，但是只是因为历史原因存在并不完全相同。

在转储中包含大对象。除非指定了--schema, --table, --schema-only开关，否则这是默认行为。因此-b 开关仅用于在选择性转储的时候添加大对象。

输出命令在输出创建数据库命令之前先清理(drop)该数据库对象。 （如果任何对象在目标数据库中不存在，则转储可能生成一些无害的错误信息。）

这个选项只是对纯文本格式有意义。对于归档格式，可以在调用pg_restore的时候声明该选项。

以一条创建该数据库本身并且与这个数据库连接命令开头进行输出。如果是这种形式的脚本， 那么你在运行脚本之前和目的安装中的哪个数据库连接就不重要了。如果也声明了 --clean，那么脚本在重新连接到数据库之前删除并重新创建目标数据库。

这个选项只对纯文本格式有意义。对于归档格式，可以在调用pg_restore 的时候声明该选项。

以指定的字符集编码创建转储。缺省时，转储是按照数据库编码创建的。 另外一个获取同样结果的方法是将PGCLIENTENCODING环境变量设置为期望的转储编码。

把输出发往指定的文件。文件基础输出格式时可以省略这个参数，这种情况下使用标准输出。 但是，在声明目标目录而不是文件时必须给出目录输出格式。在这种情况下， 目录通过pg_dump创建并且必须之前不存在。

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

一个现在已经不用了的废弃选项。

通过同时转储njobs表并行运行转储。 该选项减少了转储的时间，但是也增加了数据库服务器的负载。可以只将这个选项用于目录输出格式， 因为这是多进程可以同时写它们的数据的唯一的输出格式。

pg_dump将打开njobs + 1个到数据库的连接， 所以确保你的max_connections设置足够高以适应所有的连接。

运行并行转储时在数据库对象上请求排他锁会导致转储失败。原因是pg_dump 主进程在工作进程稍后转储的对象上请求共享锁，这样做是为了确保在转储运行时没有人删除它们或移走它们。 如果另一个客户端然后在一个表上请求一个排他锁，该锁将不被授予，但是将会排队等候主进程的共享锁释放。 因此，任意其他访问表的请求也将不被授予，并且会在排他锁请求后排队。 这包含工作进程尝试转储这个表。没有防范措施这将是一个经典的死锁情况。为了检测这个冲突， pg_dump工作进程请求使用NOWAIT选项请求另外一个共享锁。 如果没有授予工作进程这个共享锁，那么肯定是另外一个人在此期间请求了一个排他锁， 并且没有办法继续进行转储了，所以pg_dump只能退出转储。

对于一个一致的备份，数据库服务器需要支持同步快照，这是PostgreSQL 9.2 引入的一个特性。有了这个特性，数据库客户端可以保证他们看到相同的数据设置，即使它们使用不同的连接。 pg_dump -j使用多个数据库连接；它与主进程连接到数据库一次，然后再次连接到每个worker工作。 没有同步快照特性，不同的worker工作将不会保证在每个连接中看到相同的数据，这将导致一个不一致的备份。

如果你想在一个9.2之前的服务器上运行并行转储，那么你需要保证在主进程到最后一个worker工作连接到数据库之间， 数据库内容不会改变。最简单的方法是在开始备份之前叫停所有数据修改进程（DDL和DML）访问数据库。 你也需要在9.2之前的PostgreSQL服务器上运行pg_dump -j 时，声明--no-synchronized-snapshots参数。

只转储匹配schema的模式内容， 包括模式本身以及其中包含的对象。如果没有声明这个选项， 所有目标数据库中的非系统模式都会被转储出来。可以使用多个-n选项指定多个模式。 同样，schema参数将按照psql 的\d命令的规则(参见匹配模式) 被解释为匹配模式，因此可以使用通配符匹配多个模式。在使用通配符的时候，最好用引号进行界定， 以防止 shell 将通配符进行扩展。参阅例子。

不转储任何匹配schema的模式内容。 模式匹配规则与-n完全相同。可以指定多个-N以排除多种匹配的模式。

如果同时指定了-n和-N，那么将只转储匹配-n 但不匹配-N的模式。如果出现-N但是不出现-n， 那么匹配-N的模式将不会被转储。

作为数据的一部分，为每个表都输出对象标识(OIDs)。 如果你的应用需要OID字段的话(比如在外键约束中用到)，那么使用这个选项。 否则，不应该使用这个选项。

不把对象的所有权设置为对应源数据库。pg_dump默认发出 ALTER OWNER或SET SESSION AUTHORIZATION 语句以设置创建的数据库对象的所有权。如果这些脚本将来没有被超级用户 (或者拥有脚本中全部对象的用户)运行的话将会失败。-O 选项就是为了让该脚本可以被任何用户恢复并且将脚本中对象的所有权赋予该选项指定的用户。

这个选项只是对纯文本格式有意义。对于归档格式，在调用pg_restore 的时候可以声明该选项。

这个选项已经过时，但是出于向下兼容的考虑，仍然接受这个选项。

只输出对象定义(模式)，不输出数据。

这个选项与--data-only相反。类似于，但是由于历史原因不等于声明 --section=pre-data --section=post-data。

不要与--schema选项混淆，--schema使用不同含义的"schema"。

排除表数据只是数据库中表的一个子集，参阅--exclude-table-data。

指定关闭触发器时需要用到的超级用户名。它只有使用了--disable-triggers 的时候才有影响。一般情况下最好不要输入这个参数，而是用超级用户启动生成的脚本。

只转储出匹配table的表（或视图、序列、外表）。 可以使用多个-t选项匹配多个表。同样，table 参数将按照psql的\d命令的规则(参见 匹配模式)被解释为匹配模式， 因此可以使用通配符匹配多个模式。在使用通配符的时候，最好用引号进行界定， 以防止 shell 将通配符进行扩展。参阅例子。

使用了-t之后，-n和-N选项就失效了。因为被-t 选中的表将无视-n和-N选项而被转储，同时除了表之外的其他对象不会被转储。

不要转储任何匹配table模式的表。 模式匹配规则与-t完全相同。可以指定多个-T以排除多种匹配的表。

如果同时指定了-t和-T，那么将只转储匹配-t 但不匹配-T的表。如果出现-T但是不出现-t， 那么匹配 -T的表将不会被转储。

指定冗余模式。这样将令pg_dump 输出详细的对象评注以及转储文件的启停时间和进度信息到标准错误上。

打印pg_dump版本然后退出。

禁止转储访问权限(grant/revoke 命令)。

指定要使用的压缩级别。0表示不压缩。对于自定义归档格式，指定单个表数据段的压缩， 并且缺省是中等水平的压缩。对于纯文本输出，设置非零压缩级别会压缩整个输出文件， 就像通过gzip反馈回来一样；但是缺省是不压缩的。 tar归档模式当前不支持压缩。

此选项用于在线升级工具。不建议也不支持用于其他目的。该选项的行为可能会在将来的版本中改变。

把数据转储为带有明确字段名的INSERT命令 (INSERT INTO table (column, ...) VALUES ...)。这样会导致恢复非常缓慢，它主要用于制作那种可以用于其它非 PostgreSQL数据库的转储。由于这个选项为每条记录都生成一条命令， 因此如果其中某一行命令出错，那么将仅有该行数据丢失，而不是整个表的数据丢失。

这个选项关闭使用美元符界定函数体。强制它们用 SQL 标准的字符串语法的引号包围。

这个选项只是和创建仅有数据的转储相关。它告诉pg_dump 包含在恢复数据时临时关闭目标表上触发器的命令。如果在表上有参照完整性检查或者其它触发器， 而恢复数据的时候不想重载他们，那么就应该使用这个选项。

目前，为--disable-triggers发出的命令必须以超级用户来执行。因此， 你应该同时用-S声明一个超级用户名， 或者最好是用一个超级用户的身份来启动这个生成的脚本。

这个选项只对纯文本格式有意义。对于归档格式，可以在调用pg_restore 的时候声明这个选项。

不要转储任何匹配table模式的表。 模式匹配规则与-t完全相同。可以给出多个--exclude-table-data 以排除多个匹配的表。当你需要指定表的定义时该选项是有用的，即使你不需要表里面的数据。

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

将数据输出为的INSERT命令(而不是COPY)。 这样会导致恢复非常缓慢。这个选项主要用于制作那种可以用于其它非 PostgreSQL数据库的转储。由于这个选项为每条记录都生成一条命令， 因此如果其中某一行命令出错，那么将仅有该行数据丢失，而不是整个表的数据丢失。 请注意，如果你重新排列了字段顺序，那么恢复可能会完全失败。 --column-inserts更安全，但是也更慢。

在转储开始的时候不要等待请求一个共享表锁。相反，如果无法在指定的 timeout内锁住表则失败。 timeout可以用任意SET statement_timeout接受的格式声明。 （允许的值依赖于你转储的服务器版本，但是自7.3以来，所有的版本都接受毫秒的整数值。 当从7.3以前的版本服务器中转储时，省略该选项。）

不转储安全标签。

该选项允许在9.2以前的服务器上运行pg_dump -j，参阅-j 参数的文档获取更多信息。

不要输出选择表空间的命令。有了该选项，所有对象在转储期间都将在缺省的表空间中创建。

这个选项只是对纯文本格式有意义。对于归档格式，在调用pg_restore 的时候可以声明该选项。

不要转储未记录表的内容。该选项对于表定义（模式）是否转储没有影响； 它只阻止转储表的数据。当从备用服务器转储时，未记录表中的数据总是排除。

强制给所有标识符加上引号。这在转储一个数据库到一个可能引入了额外关键字的新版本中时可能是有用的。

只转储命名的章节。该章节名可以是pre-data, data, 或 post-data。可以多次声明这个选项以选择多个章节。 缺省是转储所有章节。

数据章节包含实际的表数据、大对象内容和序列值。原始数据项包含索引、触发器、 规则和约束（除了验证检查约束）的定义。之前的数据项包含所有其他数据定义项。

为转储使用一个可串行化的事务，以保证使用的快照和稍后的数据库状态一致； 做这些是通过等待事务流中的一个点，该点没有异常会出现，所以不会有转储失败或导致其他事务 serialization_failure而回滚的风险。参阅第 13 章 获取关于事务隔离和并发控制的更多信息。

这个选项对于只打算灾难恢复的转储没有益处。对于原始数据库仍然在更新时， 加载一个数据库的拷贝作为报告或其他只读加载共享的转储是有帮助的。 没有这个选项，转储会反应一个与任何事务最终提交的序列化执行不一致的状态。 例如，如果使用了批处理技术，可能会在转储中显示一部分，而不是批处理中的所有条目。

在pg_dump开始时，如果没有读写事务在活动，则这个选项没有什么影响。 如果有读写事务在活动，那么转储开始时可能会延迟一段不确定的时间。 一旦运行，有没有开关的性能是一样的。

输出符合 SQL 标准的SET SESSION AUTHORIZATION命令而不是ALTER OWNER 命令来确定对象所有权。这样令转储更加符合标准，但是如果转储文件中的对象的历史有些问题， 那么可能不能正确恢复。并且，使用SET SESSION AUTHORIZATION 的转储需要数据库超级用户的权限才能转储成功，而ALTER OWNER需要的权限则低得多。

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

声明要连接的数据库名称。相当于在命令行中声明dbname 作为第一个非选项参数。

如果这个参数包含一个=符号或以一个有效的URI前缀 (postgresql://或postgres://)开始， 那么将其看做一个conninfo字符串。参阅第 31.1 节 获取更多信息。

指定运行服务器的主机名。如果数值以斜杠开头，则被用作到 Unix 域套接字的路径。 缺省从PGHOST环境变量中获取(如果设置了的话)，否则，尝试一个 Unix 域套接字连接。

指定服务器正在侦听的 TCP 端口或本地 Unix 域套接字文件的扩展(描述符)。 缺省使用PGPORT环境变量(如果设置了的话)，否则，编译时的缺省值。

连接的用户名。

从不发出密码提示问题。如果服务器要求密码认证并且密码不可用于其他意思如 .pgpass文件，则连接尝试将会失败。 该选项在批量工作和不存在用户输入密码的脚本中很有帮助。

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

这个选项从来不是至关重要的，因为如果服务器需求密码认证，则pg_dump 自动提示一个密码。不过，pg_dump 将在找出服务器想要一个密码上浪费一个连接尝试。在某些情况下，值得输入-W 以避免额外的连接尝试。

指定创建转储的角色名。这个选项导致连接到数据库之后pg_dump 发出一个SET ROLE rolename命令。 当认证的用户（通过-U指定）缺乏pg_dump所需的权限时是很有用的， 可以转变成有所需权限的角色。一些安装有反对作为超级用户直接登录的政策， 使用这个选项允许转储不违反该政策。

缺省连接参数。