PostgreSQL / 系统课时

配置 restore_command 提供 WAL

配置 restore_command 提供 WAL

PITR 启动后会按恢复进度逐个请求归档文件。restore_command 的关键不是“批量还原 WAL”,而是按 PostgreSQL 给出的 %f 和 %p 精确取回单个文件,并用退出状态明确说明本次获取是否成功。

学习目标

  • 正确理解 %f、%p 与 restore_command 的调用契约
  • 用包装脚本保证成功时文件完整、失败时返回非零状态
  • 在真正启动 PITR 前分别验证存在文件与缺失文件两条路径

理解恢复命令的调用契约

恢复进程需要归档文件时,会把请求的归档文件名替换进 %f,把 PostgreSQL 希望写入的目标路径替换进 %p。命令只有在完整文件已经安装到 %p 后才能返回 0;没有找到文件、复制失败或安装失败都应返回非零状态。

%f 不一定只代表 WAL 段,恢复过程中还可能请求时间线历史文件,例如以 .history 结尾的文件;同时不要假设 %p 的文件名与 %f 相同。请求一个归档中不存在的文件本身也不一定代表恢复链损坏,因此脚本应如实返回失败,而不是创建空文件或伪造成功。

restore_command WAL 获取与返回码分支

用包装脚本稳定处理返回码

直接使用 cp /archive/%f %p 能覆盖最简单场景,但包装脚本更容易清理临时文件并保证“完整复制后才可见”。下面以本机归档目录 /srv/postgresql/wal-archive 为例,先复制到与 %p 同目录的临时文件,再用 mv 原子替换目标。

bash
#!/usr/bin/env bash
set -u

archive_name=$1
dest_path=$2
archive_root=/srv/postgresql/wal-archive
source_path="$archive_root/$archive_name"
temp_path="${dest_path}.tmp.$$"

if [[ ! -f "$source_path" ]]; then
  echo "archive file not found: $archive_name" >&2
  exit 1
fi

# 只有完整复制成功后,才把临时文件安装到 PostgreSQL 指定的目标路径。
if ! cp -- "$source_path" "$temp_path"; then
  rm -f -- "$temp_path"
  echo "archive copy failed: $archive_name" >&2
  exit 2
fi

if ! mv -f -- "$temp_path" "$dest_path"; then
  rm -f -- "$temp_path"
  echo "archive install failed: $archive_name" >&2
  exit 2
fi

exit 0

预期结果

text
source exists and install succeeds -> exit 0
source missing -> exit 1
copy or install fails -> exit 2

这是完整脚本,可保存为 /usr/local/sbin/pg-restore-wal。对 PostgreSQL 来说只有 0 表示成功;普通非零退出状态会让本次归档获取被视为失败,而脚本不存在、Shell 无法执行命令或进程被某些信号终止等情况可能直接中止恢复,因此脚本路径、权限和依赖也必须在启动前验证。

安装脚本后,选取归档中一个真实存在的文件做一次端到端校验:

bash
sudo install -o root -g root -m 0755 pg-restore-wal /usr/local/sbin/pg-restore-wal
sudo -u postgres /usr/local/sbin/pg-restore-wal <WAL_FILE> /tmp/pitr-wal-test
status=$?
echo "exit=$status"
sudo -u postgres cmp "/srv/postgresql/wal-archive/<WAL_FILE>" /tmp/pitr-wal-test && echo "archive copy verified"
sudo rm -f /tmp/pitr-wal-test

预期输出

text
exit=0
archive copy verified

<WAL_FILE> 替换为归档中真实存在的 WAL 段文件名。若返回 0 但 cmp 失败,说明脚本违背了成功契约,不能用于 PITR。

写入 restore_command 并启用恢复模式

把命令写入恢复实例实际读取的 PostgreSQL 配置。双引号用于保护 %f 和 %p 展开后的参数边界,外层仍是 PostgreSQL 的配置字符串。

text
restore_command = '/usr/local/sbin/pg-restore-wal "%f" "%p"'

这是配置片段,不直接产生控制台输出。对 PostgreSQL 12 及以上版本,还需要在恢复数据目录中创建 recovery.signal;若要恢复到指定时间、LSN 或事务,也应在第一次启动前完成相应恢复目标配置。

bash
export RECOVERY_DIR=/srv/postgresql/pitr-data
sudo -u postgres touch "$RECOVERY_DIR/recovery.signal"
sudo -u postgres test -f "$RECOVERY_DIR/recovery.signal" && echo "recovery mode: enabled"

预期输出

text
recovery mode: enabled

启动前还应确认归档目录对 postgres 用户可读、脚本可执行,并确保恢复实例使用的确实是刚才修改的配置文件和数据目录。

验证缺失文件不会被伪装成成功

最后主动请求一个确定不存在的文件。验收重点是脚本返回非零,并且目标路径没有留下可被误认成有效归档文件的内容。

bash
rm -f /tmp/pitr-missing-test
sudo -u postgres /usr/local/sbin/pg-restore-wal <MISSING_WAL_FILE> /tmp/pitr-missing-test
status=$?
echo "exit=$status"
test ! -e /tmp/pitr-missing-test && echo "destination: absent"

预期输出

text
archive file not found: <MISSING_WAL_FILE>
exit=1
destination: absent

实际日志顺序可能因标准输出和标准错误的收集方式而不同。最终只需守住两条契约:成功时完整文件到达 %p 且返回 0;失败时不留下可被误认成有效文件的目标,并返回非零状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 restore_command 提供 WAL

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通