PostgreSQL 文档检索

pg_dump --role=rolename命令行工具PG18--role=rolename 指定用于创建转储的角色名称。此选项会让 pg_dump 在连接数据库后发出 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少 pg_dump 所需权限，但可以切换到具有所需权限的角色时，此选项很有用。有些安装环境有禁止直接以超级用户登录的策略，使用此选项就可以在不违反该策略的情况下进行转储。pg_dump › 选项 pg_dump --rows-per-insert=nrows命令行工具PG18--rows-per-insert=nrows 将数据转储为 INSERT 命令（而不是 COPY）。它控制每个 INSERT 命令的最大行数。指定的值必须是大于零的数字。恢复过程中的任何错误将导致只有属于有问题的 INSERT 的行丢失，而不是整个表的内容。pg_dump › 选项 pg_dump --schema-only命令行工具PG18-s--schema-only 只转储对象定义（模式），不转储数据或统计信息。 此选项不能与 --data-only 或 --statistics-only 一起使用。它类似于指定 --section=pre-data --section=post-data，但出于历史原因，两者并不完全相同。 （不要把它与 --schema 选项混淆，后者中的“schema”一词含义不同。） …pg_dump › 选项 pg_dump --schema=pattern命令行工具PG18-n pattern--schema=pattern 只转储匹配 pattern 的模式；这既会选择模式本身，也会选择其中包含的所有对象。未指定此选项时，将转储目标数据库中的所有非系统模式。可以通过写多个 -n 开关来选择多个模式。pattern 参数按照 psql 的 \d 命令所使用的同样规则进行解释（见模式），因此也可以通过在模式中使用通配符来选择多个模式。使用通配符时，…pg_dump › 选项 pg_dump --section=sectionname命令行工具PG18--section=sectionname 仅转储指定的部分。部分名称可以是 pre-data、data 或 post-data。可以多次指定此选项以选择多个部分。默认情况下是转储所有部分。 数据部分包含实际的表数据、大对象内容、序列值，以及表、物化视图和外部表的统计信息。post-data 部分包括索引、触发器、规则、索引统计信息，以及除已验证的检查约束和非空约束之外的其他约…pg_dump › 选项 pg_dump --sequence-data命令行工具PG18--sequence-data 在转储中包含序列数据。除非指定了 --no-data、--schema-only 或 --statistics-only，否则这是默认行为。pg_dump › 选项 pg_dump --serializable-deferrable命令行工具PG18--serializable-deferrable 使用 serializable 事务来执行转储，以确保所用快照与后续数据库状态一致；但这是通过等待事务流到达一个不会出现异常的时点来实现的，从而避免转储失败或导致其他事务因 serialization_failure 而回滚。有关事务隔离和并发控制的更多信息，请参见第 13 章。 这个选项对于仅用于灾难恢复的转储没有好处。但对…pg_dump › 选项 pg_dump --snapshot=snapshotname命令行工具PG18--snapshot=snapshotname 在制作数据库转储时，使用指定的同步快照（详见表 9.100）。 当需要将转储与逻辑复制槽（参见第 47 章）或与并发会话同步时，此选项很有用。 在并行转储的情况下，将使用此选项定义的快照名称，而不是重新获取一个新快照。pg_dump › 选项 pg_dump --statistics命令行工具PG18--statistics 转储优化器统计信息。pg_dump › 选项 pg_dump --statistics-only命令行工具PG18--statistics-only 只转储统计信息，不转储模式（数据定义）或数据。会转储表、物化视图、外部表和索引的优化器统计信息。pg_dump › 选项 pg_dump --strict-names命令行工具PG18--strict-names 要求每个扩展（-e/--extension）、模式（-n/--schema）和表（-t/--table）模式在要转储的数据库中至少匹配一个扩展/模式/表。这也适用于配合 --filter 使用的过滤器。请注意，如果所有扩展/模式/表模式都找不到匹配项，那么 pg_dump 即使在不使用 --strict-names 的情况下也会报错。 此选项对 -…pg_dump › 选项 pg_dump --superuser=username命令行工具PG18-S username--superuser=username 指定在禁用触发器时要使用的超级用户名。这只在使用 --disable-triggers 时相关。（通常最好省略它，而是以超级用户身份运行生成的脚本。）pg_dump › 选项 pg_dump --sync-method=method命令行工具PG18--sync-method=method 当设为 fsync 时（这是默认值），pg_dump --format=directory 会递归打开并同步归档目录中的所有文件。 在 Linux 上，也可以改用 syncfs，让操作系统同步包含归档目录的整个文件系统。关于需要注意的问题，请参见 recovery_init_sync_method 中有关使用 syncfs 的信息。 当…pg_dump › 选项 pg_dump --table-and-children=pattern命令行工具PG18--table-and-children=pattern 这与 -t/--table 选项相同，只是它还会包含匹配 pattern 的表的任何分区或继承子表。pg_dump › 选项 pg_dump --table=pattern命令行工具PG18-t pattern--table=pattern 只转储名称匹配 pattern 的表。可以通过写多个 -t 开关来选择多个表。pattern 参数按照 psql 的 \d 命令所使用的同样规则进行解释（见模式），因此也可以通过在模式中使用通配符来选择多个表。使用通配符时，如有需要请小心为模式加引号，以防止 shell 展开通配符；见下文的示例。 除了表之外，此选项还可用于转…pg_dump › 选项 pg_dump --use-set-session-authorization命令行工具PG18--use-set-session-authorization 输出符合 SQL 标准的 SET SESSION AUTHORIZATION 命令，而不是 ALTER OWNER 命令来确定对象所有权。这会让转储更符合标准，但根据转储中对象的历史，可能无法正确恢复。另外，使用 SET SESSION AUTHORIZATION 的转储肯定需要超级用户权限才能正确恢复，而 ALT…pg_dump › 选项 pg_dump --username=username命令行工具PG18-U username--username=username 用于连接的用户名。pg_dump › 选项 pg_dump --verbose命令行工具PG18-v--verbose 指定详细模式。这会使 pg_dump 将详细的对象注释、开始/停止时间写入转储文件，并把进度消息写到标准错误。重复该选项会让更多调试级别消息出现在标准错误中。pg_dump › 选项 pg_dump --version命令行工具PG18-V--version 打印 pg_dump 的版本并退出。pg_dump › 选项 pg_dump/pg_dumpall/pg_restore章节正文PG18E.6.3.7.1. pg_dump/pg_dumpall/pg_restore 添加 pg_dump 选项 --statistics（Jeff Davis）§ § 添加 pg_dump 和 pg_dumpall 选项 --sequence-data 以转储通常会被排除的序列数据（Nathan Bossart）§ § 添加 pg_dump、pg_dumpall 和 pg_res…pg_dump/pg_dumpall/pg_restore pg_dumpall命令行工具本站词条pg_dumpall — 将一个 PostgreSQL 数据库集簇转储为脚本文件 客户端程序 pg_dumpall [ connection-option ...] [ option ...] 手册中的可执行程序 pg_dumpall 程序版本 10.23 参考清单 客户端程序 选项定义组 38 手册中的选项 只转储数据，不转储模式（数据定义）。 -a --data-only…命令行工具 · 客户端程序 pg_dumpall章节正文PG18pg_dumpall pg_dumpall — 将一个 PostgreSQL 数据库集簇转储为脚本文件大纲 pg_dumpall [connection-option...] [option...]pg_dumpall pg_dumpall --attribute-inserts命令行工具PG18--column-inserts--attribute-inserts 将数据转储为带有显式列名的 INSERT 命令（INSERT INTO table (column, ...) VALUES ...）。这会使恢复变得非常缓慢；它主要用于生成可以装入非 PostgreSQL 数据库的转储。pg_dumpall › 选项 pg_dumpall --binary-upgrade命令行工具PG18--binary-upgrade 此选项供就地升级实用程序使用。不建议也不支持将其用于其他目的。该选项的行为可能在未来的版本中更改而不另行通知。pg_dumpall › 选项 pg_dumpall --clean命令行工具PG18-c--clean 在重新创建之前，输出用于 DROP 所有已转储数据库、角色和表空间的 SQL 命令。当恢复需要覆盖现有集簇时，此选项很有用。如果目标集簇中不存在某些对象，则恢复期间会报告可忽略的错误消息，除非还指定了 --if-exists。pg_dumpall › 选项 pg_dumpall --data-only命令行工具PG18-a--data-only 只转储数据，不转储模式（数据定义）或统计信息。pg_dumpall › 选项 pg_dumpall --database=dbname命令行工具PG18-l dbname--database=dbname 指定用于转储全局对象并发现还应转储哪些数据库的连接数据库名。如果未指定，则使用 postgres 数据库；如果该数据库不存在，则使用 template1。pg_dumpall › 选项 pg_dumpall --dbname=connstr命令行工具PG18-d connstr--dbname=connstr 以连接字符串形式指定用于连接服务器的参数；这些参数将覆盖任何冲突的命令行选项。 该选项名为 --dbname，是为了与其他客户端应用程序保持一致；但由于 pg_dumpall 需要连接多个数据库，连接字符串中的数据库名将被忽略。请使用 -l 选项指定初始连接所用的数据库名，该连接将用于转储全局对象并发现还应转储哪些数据库。pg_dumpall › 选项 pg_dumpall --disable-dollar-quoting命令行工具PG18--disable-dollar-quoting 此选项禁用对函数体的美元引用，并强制用 SQL 标准字符串语法对它们加引号。pg_dumpall › 选项 pg_dumpall --disable-triggers命令行工具PG18--disable-triggers 此选项只在创建包含数据但不包含模式的转储时才相关。它指示 pg_dumpall 在输出中包含一些命令，以便在恢复数据时临时禁用目标表上的触发器。如果这些表上存在不希望在数据恢复期间触发的引用完整性检查或其他触发器，请使用此选项。 目前，为 --disable-triggers 输出的这些命令必须由超级用户执行。因此，还应通过 -S 指定一个…pg_dumpall › 选项 pg_dumpall --encoding=encoding命令行工具PG18-E encoding--encoding=encoding 在指定的字符集编码中创建转储。默认情况下，转储将以数据库编码创建。（获得相同结果的另一种方法是将 PGCLIENTENCODING 环境变量设置为所需的转储编码。）pg_dumpall › 选项 pg_dumpall --exclude-database=pattern命令行工具PG18--exclude-database=pattern 不转储名称匹配 pattern 的数据库。可以多次写 --exclude-database 开关，以排除匹配所给模式中任意一个的数据库。pattern 参数按照 psql 的\d 命令所使用的同样规则解释（见模式），因此也可以通过在模式中使用通配符来排除多个数据库。使用通配符时，如有需要请务必为模式加引号，以防止 shell…pg_dumpall › 选项 pg_dumpall --extra-float-digits=ndigits命令行工具PG18--extra-float-digits=ndigits 在转储浮点数据时，使用指定的 extra_float_digits 值，而不是最大可用精度。出于备份目的的常规转储不应使用此选项。pg_dumpall › 选项 pg_dumpall --file=filename命令行工具PG18-f filename--file=filename 将输出发送到指定文件。如果省略此选项，则使用标准输出。pg_dumpall › 选项 pg_dumpall --filter=filename命令行工具PG18--filter=filename 指定一个文件名，从中读取要从转储中排除的数据库名称的匹配模式。这些模式按照与 --exclude-database 相同的规则解释。要从 STDIN 读取，请使用-作为文件名。--filter 可与 --exclude-database 结合使用以排除数据库，也可以指定多次以读取多个过滤文件。 该文件每行列出一个数据库名匹配模式，格式如下： …pg_dumpall › 选项 pg_dumpall --globals-only命令行工具PG18-g--globals-only 只转储全局对象（角色和表空间），不转储数据库。pg_dumpall › 选项 pg_dumpall --help命令行工具PG18-?--help 显示关于 pg_dumpall 命令行参数的帮助信息，并退出。pg_dumpall › 选项 pg_dumpall --host=host命令行工具PG18-h host--host=host 指定运行数据库服务器的机器的主机名。如果该值以斜杠开头，则将其用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果已设置）；否则会尝试使用 Unix 域套接字连接。pg_dumpall › 选项 pg_dumpall --if-exists命令行工具PG18--if-exists 使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean，否则此选项无效。pg_dumpall › 选项 pg_dumpall --inserts命令行工具PG18--inserts 将数据转储为 INSERT 命令（而不是 COPY）。这会使恢复非常缓慢；它主要用于生成可以装入非 PostgreSQL 数据库的转储。注意，如果重新安排了列顺序，恢复可能会彻底失败。--column-inserts 选项可以避免列顺序变化带来的问题，但速度更慢。pg_dumpall › 选项