↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3
历史版本。 PostgreSQL 9.6 已结束支持。 2021-11-11. 请参阅 当前版本手册.

pg_resetxlog

pg_resetxlog — 重置一个 PostgreSQL 数据库集簇的事务日志及其他控制信息

大纲

pg_resetxlog [-f] [-n] [option...] {[-D] datadir}

描述

pg_resetxlog 清空事务日志(WAL),并有选择地重置 pg_control 文件中存储的一些其他控制信息。当这些文件损坏时,有时就需要这项功能。它应当只作为最后的手段使用,即当服务器因这种损坏而无法启动时。

运行这条命令之后,应当就能启动服务器了,但请记住,由于部分提交的事务,数据库中可能包含不一致的数据。你应当立即转储数据、运行 initdb 并重新装载。重新装载之后,检查不一致之处并按需修复。

这个工具只能由安装服务器的用户运行,因为它需要对数据目录的读写访问权限。出于安全原因,你必须在命令行上指定数据目录。pg_resetxlog 不使用环境变量 PGDATA。

如果 pg_resetxlog 抱怨说无法确定 pg_control 的有效数据,你可以通过指定 -f(强制)选项迫使它继续执行。在这种情况下,缺失的数据会用貌似合理的值代替。大多数字段都可以期望是匹配的,但下一个 OID、下一个事务 ID 及其纪元、下一个多事务 ID 及偏移量、WAL 起始地址这些字段可能需要人工协助。这些字段可以用下面讨论的选项来设置。如果你无法为所有这些字段确定正确的值,仍可以使用 -f,但恢复出的数据库必须受到比平常更多的怀疑:必须立即转储并重新装载。在转储之前不要在数据库中执行任何修改数据的操作,因为任何此类操作都很可能使损坏加剧。

选项

-f

即使 pg_resetxlog 无法确定 pg_control 的有效数据,也强制它继续执行,如上文所述。

-n

-n(不操作)选项指示 pg_resetxlog 打印从 pg_control 重建的值以及即将更改的值,然后不做任何修改直接退出。这主要是一种调试工具,但在真正让 pg_resetxlog 执行之前,也可以用作健全性检查。

-V
--version

显示版本信息然后退出。

-?
--help

显示帮助然后退出。

只有当 pg_resetxlog 无法通过读取 pg_control 确定合适的值时,才需要下列选项。安全值可以按下述方法确定。对于接受数值参数的选项,可以使用前缀 0x 指定十六进制值。

-c xid,xid

手动设置可检索提交时间的最旧和最新事务 ID。

可检索提交时间的最旧事务 ID 的安全值(第一部分)可以通过在数据目录下的 pg_commit_ts 目录中查找数值最小的文件名来确定。反之,可检索提交时间的最新事务 ID 的安全值(第二部分)可以通过在同一目录中查找数值最大的文件名来确定。文件名为十六进制。

-e xid_epoch

手动设置下一个事务 ID 的纪元。

事务 ID 纪元实际上并不存储在数据库中的任何地方(由 pg_resetxlog 设置的字段除外),因此就数据库本身而言,任何值都可以。你可能需要调整这个值以确保 Slony-I 和 Skytools 等复制系统正常工作—— 如果需要,应该可以从下游复制数据库的状态中获得合适的值。

-l xlogfile

手动设置 WAL 起始地址。

WAL 起始地址应当大于数据目录下 pg_xlog 目录中现存的任何 WAL 段文件名。这些名称同样是十六进制的,并且分为三部分。第一部分是“时间线 ID”,通常应保持不变。例如,如果 00000001000000320000004A 是 pg_xlog 中最大的项,则使用 -l 00000001000000320000004B 或更高的值。

注意

pg_resetxlog 本身会查看 pg_xlog 中的文件,并选择一个超出最后一个现存文件名的默认 -l 设置。因此,只有当你知道存在当前不在 pg_xlog 中的 WAL 段文件(例如离线归档中的条目),或者 pg_xlog 的内容已完全丢失时,才需要手动调整 -l。

-m mxid,mxid

手动设置下一个和最旧的多事务 ID。

下一个多事务 ID 的安全值(第一部分)可以通过在数据目录下的 pg_multixact/offsets 目录中查找数值最大的文件名、加一、再乘以 65536(0x10000)来确定。反之,最旧多事务 ID 的安全值(-m 的第二部分)可以通过在同一目录中查找数值最小的文件名再乘以 65536 来确定。文件名为十六进制,因此最简单的做法是用十六进制指定选项值并追加四个零。

-o oid

手动设置下一个 OID。

没有同样简单的方法来确定一个超出数据库中最大 OID 的下一个 OID,但幸运的是,下一个 OID 设置得是否正确并不关键。

-O mxoff

手动设置下一个多事务偏移量。

安全值可以通过在数据目录下的 pg_multixact/members 目录中查找数值最大的文件名、加一、再乘以 52352(0xCC80)来确定。文件名为十六进制。这里没有像其他选项那样追加零的简单方法。

-u xid

手动设置最旧的未冻结事务 ID。

安全值可以通过在数据目录下的 pg_xact 目录中查找数值最小的文件名再乘以 1048576(0x100000)来确定。注意文件名为十六进制。通常最简单的做法是用十六进制指定选项值。例如,如果 0007 是 pg_xact 中最小的项,则 -u 0x700000 可行(五个尾随零提供正确的乘数)。

-x xid

手动设置下一个事务 ID。

安全值可以通过在数据目录下的 pg_clog 目录中查找数值最大的文件名、加一、再乘以 1048576(0x100000)来确定。注意文件名为十六进制。通常最简单的做法是用十六进制指定选项值。例如,如果 0011 是 pg_clog 中最大的项,则 -x 0x1200000 可行(五个尾随零提供正确的乘数)。

注解

服务器正在运行时不得使用这条命令。如果 pg_resetxlog 在数据目录中发现服务器锁文件,它将拒绝启动。如果服务器崩溃过,可能会留下锁文件;这种情况下你可以删除锁文件以允许 pg_resetxlog 运行。但在这样做之前,请务必再三确认没有仍然存活的服务器进程。

pg_resetxlog 只能用于同一大版本的服务器。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.