PostgreSQL 文档检索

pg_restore --no-data-for-failed-tables命令行工具PG18--no-data-for-failed-tables 默认情况下，即使表的创建命令失败（例如因为表已经存在），表数据仍然会被恢复。使用此选项时，这类表的数据会被跳过。如果目标数据库已经包含所需的表内容，这种行为会很有用。例如，PostgreSQL 扩展（如 PostGIS）的辅助表可能已经装载到目标数据库中；指定此选项可以防止向这些表装载重复或过时的数据。 此选项仅在直接恢复…pg_restore › 选项 pg_restore --no-owner命令行工具PG18-O--no-owner 不输出用于设置对象所有权以匹配原始数据库的命令。默认情况下，pg_restore 会发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句，为所创建的模式元素设置所有权。除非对数据库的初始连接由超级用户发起（或者由脚本中所有对象的同一所有者发起），否则这些语句会失败。使用 -O 时，初始连接可以使用任意用户名，并且该…pg_restore › 选项 pg_restore --no-password命令行工具PG18-w--no-password 绝不发出密码提示。如果服务器要求密码认证，而又无法通过 .pgpass 文件等其他方式获得密码，则连接尝试将失败。在没有用户在场输入密码的批处理作业和脚本中，此选项很有用。pg_restore › 选项 pg_restore --no-policies命令行工具PG18--no-policies 不输出用于恢复行安全性策略的命令，即使归档中包含它们。pg_restore › 选项 pg_restore --no-publications命令行工具PG18--no-publications 不输出用于恢复发布的命令，即使归档中包含它们。pg_restore › 选项 pg_restore --no-reconnect命令行工具PG18-R--no-reconnect 这个选项已经过时，但仍然被接受以保持向后兼容性。pg_restore › 选项 pg_restore --no-schema命令行工具PG18--no-schema 不输出用于恢复模式（数据定义）的命令，即使归档中包含它们。pg_restore › 选项 pg_restore --no-security-labels命令行工具PG18--no-security-labels 不输出用于恢复安全标签的命令，即使归档中包含它们。pg_restore › 选项 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_rewind命令行工具本站词条pg_rewind — 将一个 PostgreSQL 数据目录与另一个从其分叉而来的数据目录同步 服务端程序 pg_rewind [ option ...] { -D | --target-pgdata } directory { --source-pgdata= directory | --source-server= connstr } 手册中的可执行程序 pg_rewi…命令行工具 · 服务端程序 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 › 选项