PostgreSQL 文档检索
PG 18 · 按类别浏览,或输入名称与关键词
分类索引819
pg_recvlogical --verbose-v--verbose
启用详细模式。pg_recvlogical › 选项
pg_recvlogical --version-V--version
打印pg_recvlogical的版本并退出。pg_recvlogical › 选项
pg_resetwalpg_resetwal — 重置 PostgreSQL 数据库集簇的预写式日志及其他控制信息
服务端程序
pg_resetwal [ -f ] [ -n ] [ option ...] {[ -D ] datadir }
手册中的可执行程序 pg_resetwal
程序版本 10.23
参考清单 服务端程序
选项定义组 12
手册中的选项
如上所述,即使 pg_resetwa…命令行工具 · 服务端程序
pg_resetwal --char-signedness=option--char-signedness=option
手工设置默认的 char 有符号性。可选值为 signed 和 unsigned。 对于由 pg_upgrade 从 18 之前的 PostgreSQL 版本升级而来的数据库集簇,安全值应为升级前运行该集簇的平台上默认的 char 有符号性。对于所有其他集簇,signed 就是安全值。不过,该选项专供 pg_upgrade 使用…pg_resetwal › 选项
pg_resetwal --commit-timestamp-ids=xid,xid-c xid,xid--commit-timestamp-ids=xid,xid
手工设置可检索提交时间的最旧和最新事务 ID。 可检索提交时间的最旧事务 ID 的安全值(第一部分),可以通过查看数据目录下 pg_commit_ts 目录中数值最小的文件名来确定。相反,可检索提交时间的最新事务 ID 的安全值(第二部分),可以通过查看同一目录中数值最大的文件名来确定。文件名均为…pg_resetwal › 选项
pg_resetwal --dry-run-n--dry-run
-n/--dry-run 选项会让 pg_resetwal 打印从 pg_control 重建出的值以及即将更改的值,然后在不做任何修改的情况下退出。这主要是调试工具,但在真正允许 pg_resetwal 执行之前,也可用作合理性检查。pg_resetwal › 选项
pg_resetwal --epoch=xid_epoch-e xid_epoch--epoch=xid_epoch
手工设置下一个事务 ID 的纪元。 事务 ID 纪元实际上并未存储在数据库中的任何地方,除了由 pg_resetwal 设置的这个字段,因此就数据库本身而言,任何值都可用。可能需要调整该值,以确保 Slony-I 和 Skytools 等复制系统正常工作 — 如果确有需要,应该可以从下游复制数据库的状态中获得合适的值。pg_resetwal › 选项
pg_resetwal --force-f--force
即使在可能有危险的情况下,也强制 pg_resetwal 继续执行,如上文所述。具体来说,如果服务器未被干净关闭,或者 pg_resetwal 无法为 pg_control 确定有效数据,则必须指定该选项。pg_resetwal › 选项
pg_resetwal --help-?--help
显示帮助,然后退出。pg_resetwal › 选项
pg_resetwal --multixact-ids=mxid,mxid-m mxid,mxid--multixact-ids=mxid,mxid
手工设置下一个和最旧的多事务 ID。 下一个多事务 ID 的安全值(第一部分)可以通过查看数据目录下 pg_multixact/offsets 目录中数值最大的文件名,先加一,再乘以 65536 (0x10000) 来确定。相反,最旧的多事务 ID 的安全值(-m 的第二部分)可以通过查看同一目录中数值…pg_resetwal › 选项
pg_resetwal --multixact-offset=mxoff-O mxoff--multixact-offset=mxoff
手工设置下一个多事务偏移量。 安全值可以通过查看数据目录下 pg_multixact/members 目录中数值最大的文件名,先加一,再乘以 52352 (0xCC80) 来确定。文件名是十六进制。这里没有像其他选项那样通过追加零即可得到结果的简单方法。pg_resetwal › 选项
pg_resetwal --next-oid=oid-o oid--next-oid=oid
手工设置下一个 OID。 并没有同样简单的方法来确定一个超出数据库中最大 OID 的下一个 OID,不过幸运的是,下一个 OID 的设置是否精确并不关键。pg_resetwal › 选项
pg_resetwal --next-transaction-id=xid-x xid--next-transaction-id=xid
手工设置下一个事务 ID。 安全值可以通过查看数据目录下 pg_xact 目录中数值最大的文件名,先加一,再乘以 1048576 (0x100000) 来确定。请注意,文件名是十六进制。通常,选项值也用十六进制指定最为简单。例如,如果 0011 是 pg_xact 中最大的条目,那么 -x 0x1200000 就可…pg_resetwal › 选项
pg_resetwal --next-wal-file=walfile-l walfile--next-wal-file=walfile
通过指定下一个 WAL 段文件的名称,手工设置 WAL 起始位置。 下一个 WAL 段文件的名称应大于当前数据目录下 pg_wal 目录中现存的任意 WAL 段文件名。这些名称同样采用十六进制,并由三个部分组成。第一部分是“时间线 ID”,通常应保持不变。例如,如果 0000000100000032000000…pg_resetwal › 选项
pg_resetwal --oldest-transaction-id=xid-u xid--oldest-transaction-id=xid
手工设置最旧的未冻结事务 ID。 安全值可以通过查看数据目录下 pg_xact 目录中数值最小的文件名,再乘以 1048576 (0x100000) 来确定。请注意,文件名是十六进制。通常,选项值也用十六进制指定最为简单。例如,如果 0007 是 pg_xact 中最小的条目,那么 -u 0x700000 就可…pg_resetwal › 选项
pg_resetwal --pgdata=datadirdatadir-D datadir--pgdata=datadir
指定数据库目录的位置。出于安全原因,必须在命令行上指定数据目录。pg_resetwal 不使用环境变量 PGDATA。pg_resetwal › 选项
pg_resetwal --version-V--version
显示版本信息,然后退出。pg_resetwal › 选项
pg_resetwal --wal-segsize=wal_segment_size--wal-segsize=wal_segment_size
设置新的 WAL 段大小,单位为兆字节。该值必须是 1 到 1024(兆字节)之间的 2 的幂。更多信息请参见initdb中的同名选项。 该选项也可用于更改现有数据库集簇的 WAL 段大小,从而避免重新执行 initdb。 注意 虽然 pg_resetwal 会把 WAL 起始位置设置到超出现有最新 WAL 段文件的…pg_resetwal › 选项
pg_restorepg_restore — 从由 pg_dump 创建的归档文件恢复 PostgreSQL 数据库
客户端程序
pg_restore [ connection-option ...] [ option ...] [ filename ]
手册中的可执行程序 pg_restore
程序版本 10.23
参考清单 客户端程序
选项定义组 42
手册中的选项
仅恢复数据,不恢复模式(…命令行工具 · 客户端程序
pg_restore --clean-c--clean
在恢复数据库对象之前,发出 DROP 命令以删除将要恢复的所有对象。此选项适用于覆盖现有数据库。如果目标数据库中有任何对象不存在,则会报告可忽略的错误消息,除非同时指定了 --if-exists。pg_restore › 选项
pg_restore --create-C--create
在向其中恢复之前先创建数据库。如果同时指定了 --clean,则会在连接到目标数据库之前先删除并重新创建它。 使用 --create 时,pg_restore 还会恢复数据库的注释(如果有)以及该数据库专有的任何配置变量设置,也就是任何提到该数据库的 ALTER DATABASE ... SET ... 和 ALTER ROLE ... IN DATABA…pg_restore › 选项
pg_restore --data-only-a--data-only
仅恢复数据,不恢复模式(数据定义)或统计信息。如果归档中包含,则会恢复表数据、大对象和序列值。 此选项类似于指定 --section=data,但出于历史原因,两者并不完全相同。pg_restore › 选项
pg_restore --dbname=dbname-d dbname--dbname=dbname
连接到数据库 dbname,并直接恢复到该数据库中。dbname 可以是一个连接字符串。如果是这样,连接字符串参数会覆盖任何冲突的命令行选项。pg_restore › 选项
pg_restore --disable-triggers--disable-triggers
此选项仅在执行不包含模式的恢复时才相关。它会指示 pg_restore 在恢复数据期间发出命令,临时禁用目标表上的触发器。如果你不希望在恢复数据期间触发表上的引用完整性检查或其他触发器,请使用此选项。 目前,为 --disable-triggers 发出的命令必须以超级用户身份执行。因此,你还应通过 -S 指定超级用户用户名,或者更好的是,…pg_restore › 选项
pg_restore --enable-row-security--enable-row-security
此选项仅在恢复启用了行安全性的表内容时才相关。默认情况下,pg_restore 会将row_security设置为 off,以确保所有数据都能恢复到表中。如果用户没有足够的权限绕过行安全性,就会抛出错误。此参数会指示 pg_restore 改为将row_security设置为 on,从而允许用户尝试在启用行安全性的情况下恢复表内容。如…pg_restore › 选项
pg_restore --exclude-schema=schema-N schema--exclude-schema=schema
不恢复位于指定模式中的对象。可以通过多次指定 -N 来排除多个模式。 当对同一模式名同时给出 -n 和 -N 时,-N 优先,该模式会被排除。pg_restore › 选项
pg_restore --exit-on-error-e--exit-on-error
如果在向数据库发送 SQL 命令时遇到错误,则退出。默认行为是继续执行,并在恢复结束时显示错误计数。pg_restore › 选项
pg_restore --file=filename-f filename--file=filename
指定生成脚本的输出文件,或者在与 -l 一起使用时指定列表输出文件。使用 - 表示 stdout。pg_restore › 选项
pg_restore --filter=filename--filter=filename
指定一个文件名,从中读取恢复时要排除或包含的对象匹配模式。这些模式按照与下列选项相同的规则解释:-n/--schema 用于包含某个模式中的对象,-N/--exclude-schema 用于排除某个模式中的对象,-P/--function 用于恢复指定函数,-I/--index 用于恢复指定索引,-t/--table 用于恢复指定表,以及 -…pg_restore › 选项
pg_restore --format=format-F format--format=format
指定归档格式。不必指定格式,因为 pg_restore 会自动确定格式。如果指定,可以是以下格式之一: ccustom # 归档采用 pg_dump 的自定义格式。 ddirectory # 归档是目录格式归档。 ttar # 归档是 tar 归档。pg_restore › 选项
pg_restore --function=function-name(argtype [, ...])-P function-name(argtype [, ...])--function=function-name(argtype [, ...])
仅恢复指定函数。请务必按转储文件目录中显示的形式准确拼写函数名和参数。可以通过多次指定 -P 来恢复多个函数。pg_restore › 选项
pg_restore --help-?--help
显示关于 pg_restore 命令行参数的帮助信息,并退出。pg_restore › 选项
pg_restore --host=host-h host--host=host
指定服务器所在机器的主机名。如果值以斜杠开头,则被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量(如果已设置),否则尝试使用 Unix 域套接字连接。pg_restore › 选项
pg_restore --if-exists--if-exists
使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean,否则此选项无效。pg_restore › 选项
pg_restore --index=index-I index--index=index
仅恢复指定名称的索引的定义。可以通过多次指定 -I 来恢复多个索引。pg_restore › 选项
pg_restore --jobs=number-of-jobs-j number-of-jobs--jobs=number-of-jobs
将 pg_restore 中最耗时的步骤,也就是装载数据、创建索引或创建约束,最多使用 number-of-jobs 个并发会话并行执行。此选项可以显著缩短将大型数据库恢复到运行在多处理器机器上的服务器所需的时间。当生成脚本而不是直接连接到数据库服务器时,此选项会被忽略。 每个作业都是一个进程或一个线…pg_restore › 选项
pg_restore --list-l--list
列出归档的目录内容(table of contents)。此操作的输出可用作 -L 选项的输入。请注意,如果在 -l 中使用 -n 或 -t 等过滤开关,它们会限制被列出的项目。pg_restore › 选项
pg_restore --no-acl-x--no-privileges--no-acl
阻止恢复访问权限(GRANT/REVOKE 命令)。pg_restore › 选项
pg_restore --no-comments--no-comments
不输出用于恢复注释的命令,即使归档中包含注释。pg_restore › 选项
pg_restore --no-data--no-data
不输出用于恢复数据的命令,即使归档中包含数据。pg_restore › 选项
更多结果
输入名称或关键词,从 PostgreSQL 手册与扩展目录中直接找到定义。
pg17: 限定版本 ex: 只搜扩展 ↑↓ 选择 ↵ 打开