PostgreSQL 文档检索

pg_dump --format=format命令行工具PG18-F format--format=format 选择输出的格式。format 可以是以下之一： pplain # 输出纯文本 SQL 脚本文件（默认）。 ccustom # 输出适合供 pg_restore 使用的 custom 格式归档。与目录输出格式一起，这是最灵活的输出格式，因为它允许在恢复时手工选择并重新排序归档条目。这种格式默认也会压缩。 ddirectory # …pg_dump › 选项 pg_dump --help命令行工具PG18-?--help 显示关于 pg_dump 命令行参数的帮助信息，并退出。pg_dump › 选项 pg_dump --host=host命令行工具PG18-h host--host=host 指定服务器所在机器的主机名。如果值以斜杠开头，则被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果已设置），否则尝试使用 Unix 域套接字连接。pg_dump › 选项 pg_dump --if-exists命令行工具PG18--if-exists 使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean，否则此选项无效。pg_dump › 选项 pg_dump --include-foreign-data=foreignserver命令行工具PG18--include-foreign-data=foreignserver 转储任何外部表的数据，只要其外部服务器匹配 foreignserver 模式。可以通过写多个 --include-foreign-data 开关来选择多个外部服务器。此外，foreignserver 参数按照 psql 的 \d 命令所使用的同样规则进行解释（见模式），因此也可以通过在模式中使用通配符来选…pg_dump › 选项 pg_dump --inserts命令行工具PG18--inserts 把数据转储为 INSERT 命令（而不是 COPY）。这会使恢复非常缓慢；它主要用于生成可装入非 PostgreSQL 数据库的转储。恢复期间发生的任何错误都只会导致有问题的 INSERT 所包含的行丢失，而不会导致整个表内容丢失。注意，如果重新安排了列顺序，恢复可能会彻底失败。--column-inserts 选项可以避免列顺序变化带来的问题，但速度更慢。pg_dump › 选项 pg_dump --jobs=njobs命令行工具PG18-j njobs--jobs=njobs 以并行方式运行转储，同时转储 njobs 个表。此选项可能减少执行转储所需的时间，但也会增加数据库服务器的负载。只能在目录输出格式下使用此选项，因为只有这种输出格式允许多个进程同时写入数据。 pg_dump 将打开 njobs + 1 个数据库连接，因此请确保max_connections设置足够高，能够容纳所有连接。 在并行转储运行期…pg_dump › 选项 pg_dump --load-via-partition-root命令行工具PG18--load-via-partition-root 当为表分区转储数据时，让 COPY 或 INSERT 语句以包含该分区的分区层次结构根为目标，而不是以该分区本身为目标。这会导致在加载数据时为每一行重新确定适当的分区。当在另一台服务器上恢复数据，而行并不总是落在与原始服务器相同的分区中时，这可能很有用。例如，如果分区列是 text 类型，而两个系统对用于排序该分区列的排序规则…pg_dump › 选项 pg_dump --lock-wait-timeout=timeout命令行工具PG18--lock-wait-timeout=timeout 在转储开始时，不要无限等待获取共享表锁。如果无法在指定的 timeout 内锁定某个表，就让转储失败。超时可以用 SET statement_timeout 接受的任意格式指定。（允许的格式因被转储源服务器的版本而异，但所有版本都接受以毫秒为单位的整数。）pg_dump › 选项 pg_dump --no-acl命令行工具PG18-x--no-privileges--no-acl 不转储访问权限（grant/revoke 命令）。pg_dump › 选项 pg_dump --no-blobs命令行工具PG18-B--no-large-objects--no-blobs（已弃用）在转储中排除大对象。 当同时给出-b和-B时，行为是在转储数据时输出大对象，请参阅-b文档。pg_dump › 选项 pg_dump --no-comments命令行工具PG18--no-comments 不要转储 COMMENT 命令。pg_dump › 选项 pg_dump --no-data命令行工具PG18--no-data 不要转储数据。pg_dump › 选项 pg_dump --no-owner命令行工具PG18-O--no-owner 不输出用于把对象所有权设置成与原始数据库一致的命令。默认情况下，pg_dump 会发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句来设置新建数据库对象的所有权。除非脚本由超级用户（或拥有脚本中所有对象的同一用户）启动，否则这些语句会在运行脚本时报错。若要创建一个可由任意用户恢复、并让该用户拥有所有对象的脚本，请…pg_dump › 选项 pg_dump --no-password命令行工具PG18-w--no-password 绝不发出密码提示。如果服务器要求密码认证，而又无法通过 .pgpass 文件等其他方式获得密码，则连接尝试将失败。在没有用户在场输入密码的批处理作业和脚本中，此选项很有用。pg_dump › 选项 pg_dump --no-policies命令行工具PG18--no-policies 不要转储行安全性策略。pg_dump › 选项 pg_dump --no-publications命令行工具PG18--no-publications 不要转储发布。pg_dump › 选项 pg_dump --no-reconnect命令行工具PG18-R--no-reconnect 这个选项已经过时，但仍然被接受以保持向后兼容性。pg_dump › 选项 pg_dump --no-schema命令行工具PG18--no-schema 不要转储模式（数据定义）。pg_dump › 选项 pg_dump --no-security-labels命令行工具PG18--no-security-labels 不要转储安全标签。pg_dump › 选项 pg_dump --no-statistics命令行工具PG18--no-statistics 不要转储统计信息。这是默认行为。pg_dump › 选项 pg_dump --no-subscriptions命令行工具PG18--no-subscriptions 不要转储订阅。pg_dump › 选项 pg_dump --no-sync命令行工具PG18--no-sync 默认情况下，pg_dump 会等待所有文件都被安全写入磁盘。该选项会使 pg_dump 立即返回而不等待，这样更快，但意味着随后如果操作系统崩溃，转储可能会损坏。通常，此选项适用于测试，但不应在从生产安装转储数据时使用。pg_dump › 选项 pg_dump --no-table-access-method命令行工具PG18--no-table-access-method 不输出用于选择表访问方法的命令。使用此选项时，所有对象在恢复时都会使用当时默认的表访问方法创建。 当生成一个归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。pg_dump › 选项 pg_dump --no-tablespaces命令行工具PG18--no-tablespaces 不输出用于选择表空间的命令。使用此选项时，所有对象在恢复时都会创建在当时默认的表空间中。 当生成一个归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。pg_dump › 选项 pg_dump --no-toast-compression命令行工具PG18--no-toast-compression 不输出用于设置 TOAST 压缩方法的命令。使用此选项时，所有列都会以默认压缩设置恢复。pg_dump › 选项 pg_dump --no-unlogged-table-data命令行工具PG18--no-unlogged-table-data 不要转储不记录 WAL 的表和序列的内容。此选项不会影响是否转储表和序列的定义（模式）；它只会抑制表和序列数据的转储。从备库转储时，不记录 WAL 的表和序列中的数据始终会被排除。pg_dump › 选项 pg_dump --on-conflict-do-nothing命令行工具PG18--on-conflict-do-nothing 添加 ON CONFLICT DO NOTHING 到 INSERT 命令中。除非同时指定了 --inserts、--column-inserts 或 --rows-per-insert，否则此选项无效。pg_dump › 选项 pg_dump --password命令行工具PG18-W--password 强制 pg_dump 在连接数据库之前提示输入密码。 这个选项绝非必需，因为如果服务器要求密码认证，pg_dump 会自动提示输入密码。不过，pg_dump 会先浪费一次连接尝试来发现服务器需要密码。在某些情况下值得输入 -W，因为可以避免这次额外的连接尝试。pg_dump › 选项 pg_dump --port=port命令行工具PG18-p port--port=port 指定服务器正在监听连接的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认值取自 PGPORT 环境变量（如果已设置），否则使用编译时默认值。pg_dump › 选项 pg_dump --quote-all-identifiers命令行工具PG18--quote-all-identifiers 强制为所有标识符加引号。当从某个服务器转储数据库，而该服务器的 PostgreSQL 主版本与 pg_dump 不同，或者输出打算装入另一主版本的服务器时，推荐使用此选项。默认情况下，pg_dump 只会为在其自身主版本中属于保留字的标识符加引号。这有时会在处理其他版本服务器时导致兼容性问题，因为这些版本的保留字集合可能略有不同。…pg_dump › 选项 pg_dump --restrict-key=restrict_key命令行工具PG18--restrict-key=restrict_key 在转储输出中，把给定字符串用作 psql 的 \restrict 键。此选项只能用于纯文本转储，也就是 --format 被设置为 plain，或者省略了 --format 选项时。若未指定该键，pg_dump 会按需要随机生成一个。键只能包含字母数字字符。 此选项主要用于测试以及其他需要可重复输出的场景（例如比较转储文件…pg_dump › 选项 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 › 选项