PostgreSQL 文档检索

pg_restore --no-statistics命令行工具PG18--no-statistics 不输出用于恢复统计信息的命令，即使归档中包含它们。pg_restore › 选项 pg_restore --no-subscriptions命令行工具PG18--no-subscriptions 不输出用于恢复订阅的命令，即使归档中包含它们。pg_restore › 选项 pg_restore --no-table-access-method命令行工具PG18--no-table-access-method 不输出用于选择表访问方法的命令。使用此选项时，所有对象在恢复时都会使用当时默认的表访问方法创建。pg_restore › 选项 pg_restore --no-tablespaces命令行工具PG18--no-tablespaces 不输出用于选择表空间的命令。使用此选项时，所有对象在恢复时都会创建在当时默认的表空间中。pg_restore › 选项 pg_restore --password命令行工具PG18-W--password 强制 pg_restore 在连接数据库之前提示输入密码。 此选项实际上并非必需，因为如果服务器要求密码认证，pg_restore 会自动提示输入密码。不过，pg_restore 会浪费一次连接尝试来发现服务器需要密码。在某些情况下，键入 -W 以避免这一次额外的连接尝试是值得的。pg_restore › 选项 pg_restore --port=port命令行工具PG18-p port--port=port 指定服务器正在监听连接的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认值取自 PGPORT 环境变量（如果已设置），否则使用编译时默认值。pg_restore › 选项 pg_restore --restrict-key=restrict_key命令行工具PG18--restrict-key=restrict_key 在转储输出中使用提供的字符串作为 psql \restrict 键。这只能用于 SQL 脚本输出，也就是使用 --file 选项时。如果未指定该键，pg_restore 会按需随机生成一个。键只能包含字母数字字符。 此选项主要用于测试以及其他需要可重复输出的场景（例如比较转储文件）。一般不建议使用它，因为若恶意服务器事先知…pg_restore › 选项 pg_restore --role=rolename命令行工具PG18--role=rolename 指定执行恢复时要使用的角色名。此选项会使 pg_restore 在连接数据库后发出 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少 pg_restore 所需的权限，但可以切换到具有所需权限的角色时，此选项会很有用。有些安装环境禁止直接以超级用户登录，而使用此选项可以在不违反该策略的情况下执行恢复。pg_restore › 选项 pg_restore --schema-only命令行工具PG18-s--schema-only 仅恢复模式（数据定义），不恢复数据，前提是归档中存在模式条目。 此选项不能与 --data-only 或 --statistics-only 一起使用。它类似于指定 --section=pre-data --section=post-data --no-statistics，但由于历史原因并不完全相同。 （不要把它与 --schema 选项混淆，…pg_restore › 选项 pg_restore --schema=schema命令行工具PG18-n schema--schema=schema 仅恢复位于指定模式中的对象。可以通过多次指定 -n 来指定多个模式。这可以与 -t 选项结合使用，只恢复特定表。pg_restore › 选项 pg_restore --section=sectionname命令行工具PG18--section=sectionname 仅恢复指定部分。部分名称可以是 pre-data、data 或 post-data。可以多次指定此选项来选择多个部分。默认是恢复所有部分。 数据部分包含实际的表数据以及大对象定义。post-data 部分由索引、触发器、规则以及除已验证检查约束之外的约束定义组成。pre-data 部分则由所有其他数据定义项组成。pg_restore › 选项 pg_restore --single-transaction命令行工具PG18-1--single-transaction 将恢复作为单个事务执行（也就是把发出的命令包裹在 BEGIN/COMMIT 中）。这可确保要么所有命令都成功完成，要么不应用任何更改。此选项隐含 --exit-on-error。pg_restore › 选项 pg_restore --statistics命令行工具PG18--statistics 如果归档中包含统计信息，则输出用于恢复统计信息的命令。这是默认行为。pg_restore › 选项 pg_restore --statistics-only命令行工具PG18--statistics-only 仅恢复统计信息，不恢复模式（数据定义）或数据。pg_restore › 选项 pg_restore --strict-names命令行工具PG18--strict-names 要求每个模式限定符（-n/--schema）和表限定符（-t/--table）至少匹配待恢复文件中的一个模式/表。pg_restore › 选项 pg_restore --superuser=username命令行工具PG18-S username--superuser=username 指定在禁用触发器时要使用的超级用户用户名。仅当使用 --disable-triggers 时才相关。pg_restore › 选项 pg_restore --table=table命令行工具PG18-t table--table=table 仅恢复指定表的定义和/或数据。这里的“表”包括视图、物化视图、序列和外部表。可以通过多次指定 -t 来选择多个表。此选项可以与 -n 选项结合使用，以指定特定模式中的表。 注意 当指定 -t 时，pg_restore 不会尝试恢复所选表可能依赖的任何其他数据库对象。因此，不能保证将特定表恢复到一个空数据库中一定会成功。 注意 此标志与…pg_restore › 选项 pg_restore --transaction-size=N命令行工具PG18--transaction-size=N 将恢复作为一系列事务执行，每个事务最多处理 N 个数据库对象。此选项隐含 --exit-on-error。 --transaction-size 在默认行为（每条 SQL 命令一个事务）与 -1/--single-transaction（所有恢复对象共用一个事务）之间提供了一个折中选择。虽然 --single-transaction 的…pg_restore › 选项 pg_restore --trigger=trigger命令行工具PG18-T trigger--trigger=trigger 仅恢复指定名称的触发器。可以通过多次指定 -T 来恢复多个触发器。pg_restore › 选项 pg_restore --use-list=list-file命令行工具PG18-L list-file--use-list=list-file 仅恢复在 list-file 中列出的归档元素，并按它们在文件中出现的顺序进行恢复。请注意，如果在 -L 中使用 -n 或 -t 等过滤开关，它们还会进一步限制被恢复的项目。 list-file 通常是通过编辑先前 -l 操作的输出来创建的。可以移动或删除行，也可以通过在行首放置分号（;）将其注释掉。示例见下文。pg_restore › 选项 pg_restore --use-set-session-authorization命令行工具PG18--use-set-session-authorization 输出符合 SQL 标准的 SET SESSION AUTHORIZATION 命令，而不是使用 ALTER OWNER 命令来确定对象所有权。这样会使转储结果更符合标准，但根据转储中对象的历史，可能无法正确恢复。pg_restore › 选项 pg_restore --username=username命令行工具PG18-U username--username=username 用于连接的用户名。pg_restore › 选项 pg_restore --verbose命令行工具PG18-v--verbose 指定详细模式。这会使 pg_restore 将详细的对象注释和开始/停止时间输出到输出文件，并将进度消息输出到标准错误。重复此选项会使标准错误中出现额外的调试级消息。pg_restore › 选项 pg_restore --version命令行工具PG18-V--version 打印 pg_restore 的版本并退出。pg_restore › 选项 pg_restore_attribute_stats函数与运算符本站词条创建或更新列级统计信息。 Creates or updates column-level statistics. pg_restore_attribute_stats ( VARIADIC kwargs "any" ) → boolean 系统管理函数函数 · 系统管理函数 pg_restore_extended_stats函数与运算符本站词条创建或更新统计对象的统计信息。 Creates or updates statistics for statistics objects. pg_restore_extended_stats ( VARIADIC kwargs "any" ) → boolean 系统管理函数函数 · 系统管理函数 pg_restore_points扩展与模块扩展目录创建、登记、列出与删除具名 PostgreSQL 恢复点。 Create, catalog, list, and remove named PostgreSQL restore points. restore-point wal backup recovery pg_restore_points 管理运维管理运维 · 扩展目录 pg_restore_relation_stats函数与运算符本站词条更新表级统计信息。 Updates table-level statistics. pg_restore_relation_stats ( VARIADIC kwargs "any" ) → boolean 系统管理函数函数 · 系统管理函数 pg_retry扩展与模块扩展目录在临时错误中使用指数退避重试语句 Retry SQL statements on transient errors with exponential backoff pg_retry 实用工具实用工具 · 扩展目录 pg_reversi扩展与模块扩展目录在 PostgreSQL 9.6 中实现 Reversi 黑白棋游戏的示例扩展。 Reversi game implemented as a PostgreSQL extension. game reversi pg_reversi 功能特性功能特性 · 扩展目录 pg_rewind命令行工具本站词条pg_rewind — 将一个 PostgreSQL 数据目录与另一个从其分叉而来的数据目录同步 服务端程序 pg_rewind [ option ...] { -D | --target-pgdata } directory { --source-pgdata= directory | --source-server= connstr } 手册中的可执行程序 pg_rewi…命令行工具 · 服务端程序 pg_rewind章节正文PG18pg_rewind pg_rewind — 将一个 PostgreSQL 数据目录与另一个从其分叉而来的数据目录同步大纲 pg_rewind [option...] { -D | --target-pgdata } directory { --source-pgdata=directory | --source-server=connstr }pg_rewind pg_rewind --config-file=filename命令行工具PG18--config-file=filename 为目标集簇使用指定的主配置文件。当 pg_rewind 在该集簇上内部使用 postgres 命令执行回卷操作时，这一选项会对其产生影响（包括使用 -c/--restore-target-wal 获取 restore_command 以及强制完成崩溃恢复时）。pg_rewind › 选项 pg_rewind --debug命令行工具PG18--debug 打印详细的调试输出，这些输出主要对调试 pg_rewind 的开发人员有用。pg_rewind › 选项 pg_rewind --dry-run命令行工具PG18-n--dry-run 执行除实际修改目标目录之外的所有操作。pg_rewind › 选项 pg_rewind --help命令行工具PG18-?--help 显示帮助，然后退出。pg_rewind › 选项 pg_rewind --no-ensure-shutdown命令行工具PG18--no-ensure-shutdown pg_rewind 要求在回卷前目标服务器已正常关闭。默认情况下，如果目标服务器未正常关闭，pg_rewind 会先以单用户模式启动目标服务器以完成崩溃恢复，然后再将其停止。指定此选项后，pg_rewind 会跳过这一步；如果服务器未正常关闭，它会立即报错。在这种情况下，用户应自行处理。pg_rewind › 选项 pg_rewind --no-sync命令行工具PG18-N--no-sync 默认情况下，pg_rewind 会等待所有文件都安全写入磁盘。此选项会使 pg_rewind 不等待就返回，这样虽然更快，但也意味着如果随后发生操作系统崩溃，数据目录可能会损坏。通常，这个选项适合测试，但不应在生产环境中使用。pg_rewind › 选项 pg_rewind --progress命令行工具PG18-P--progress 启用进度报告。打开该选项后，在从源集簇复制数据时会给出大致的进度信息。pg_rewind › 选项 pg_rewind --restore-target-wal命令行工具PG18-c--restore-target-wal 如果这些文件在 pg_wal 目录中已不可用，则使用目标集簇配置中定义的 restore_command 从 WAL 归档中取回 WAL 文件。pg_rewind › 选项