PostgreSQL / 系统课时
时间点恢复 PITR
时间点恢复 PITR
PITR 的核心是“基础备份 + 之后连续的 WAL”:先还原一个较早的一致状态,再重放 WAL,直到目标时间、LSN 或命名恢复点。本节按灾难演练的方式在独立数据目录恢复,验证目标后再结束恢复,避免直接覆盖生产实例。
学习目标
- 区分按时间、LSN 和命名恢复点停止重放的适用场景
- 配置
restore_command、恢复目标和recovery.signal - 在暂停点验证数据,并安全决定继续、结束或重新恢复
先确定可恢复链路
PITR 不能只靠 WAL,也不能只靠基础备份。基础备份提供起点,归档 WAL 提供从起点向后的变化历史;中间缺少任意一个必需 WAL 段,恢复就无法越过缺口。演练时应复制基础备份到新的 PGDATA,并使用独立端口启动,绝不要在验证前覆盖原实例。

三类常用目标解决的问题不同:时间目标适合“已知误操作发生在几点”;LSN 适合已有精确 WAL 位置;命名恢复点适合在发布、批处理或迁移前主动打标。一次恢复只设置一个主目标,避免互相覆盖意图。
创建可识别的恢复点
若能在高风险操作前主动标记,命名恢复点通常最容易解释。它会把一个带名称的标记写入 WAL,之后可用 recovery_target_name 精确停止。
SELECT pg_create_restore_point('before_batch') AS restore_lsn;预期结果
restore_lsn
-------------
<LSN><LSN> 是实际 WAL 位置。恢复点必须已经进入你保留的 WAL 链;仅记住名称而没有对应 WAL 文件,无法完成恢复。
配置恢复实例
以下假设 /backup/base/ 是可用于恢复的基础备份目录,/var/lib/postgresql/wal-archive/ 保存连续归档 WAL,<PATH>/pgdata-recovery 是新的恢复目录,且没有需要单独映射的外部表空间。先复制基础备份并创建恢复信号文件。
set -euo pipefail
RECOVERY_DIR="<PATH>/pgdata-recovery"
rsync -a --delete /backup/base/ "$RECOVERY_DIR/"
rm -f "$RECOVERY_DIR/standby.signal"
touch "$RECOVERY_DIR/recovery.signal"预期结果
命令成功时无标准输出;<PATH>/pgdata-recovery/recovery.signal 已存在然后在恢复实例的 postgresql.conf 中设置取 WAL 的命令和停止目标。下面选择命名恢复点;若要按时间或 LSN 恢复,只保留对应的一项。
restore_command = 'cp /var/lib/postgresql/wal-archive/%f %p'
recovery_target_name = 'before_batch'
# recovery_target_time = '<TIME>'
# recovery_target_lsn = '<LSN>'
recovery_target_timeline = 'latest'
recovery_target_action = 'pause'
hot_standby = on
archive_mode = off<TIME> 应替换为带 UTC 偏移或完整时区的时间戳,<LSN> 应替换为真实 WAL 位置,避免演练机器和生产机器时区不同造成误判。recovery_target_action = 'pause' 会在目标处先停住,让你查询恢复后的数据库;演练副本关闭归档可避免验证结束后把新时间线的 WAL 写回生产归档目录。
启动并验证停止位置
用独立端口启动恢复副本。服务器检测到 recovery.signal 后进入归档恢复,通过 restore_command 请求所需 WAL,并持续重放到目标。
set -euo pipefail
RECOVERY_DIR="<PATH>/pgdata-recovery"
PORT="<PORT>"
pg_ctl -D "$RECOVERY_DIR" -o "-p $PORT" start
psql -X -p "$PORT" -c "
SELECT
pg_is_in_recovery() AS in_recovery,
pg_get_wal_replay_pause_state() AS pause_state,
pg_last_wal_replay_lsn() AS replay_lsn;
"预期结果
in_recovery | pause_state | replay_lsn
-------------+-------------+------------
t | paused | <LSN>实际 <PORT> 和 <LSN> 会不同。此时不要只看“服务启动成功”,还要检查业务不变量:误删对象是否重新出现、错误批次的数据是否尚未生效、关键表行数或校验值是否符合目标时刻。PITR 的验收对象是业务状态,不是单纯的恢复日志。
选择时间、LSN 或恢复点
| 目标 | 配置项 | 适合场景 | 关键边界 |
|---|---|---|---|
| 时间 | recovery_target_time |
已知事故发生时间 | 依赖时间记录准确,需明确时区 |
| LSN | recovery_target_lsn |
已拿到精确 WAL 位置 | 最精确,但需要可靠地记录 LSN |
| 恢复点 | recovery_target_name |
发布、迁移、批任务前预先打标 | 必须先创建且对应 WAL 未丢失 |
时间和 LSN 目标还可用 recovery_target_inclusive 控制是否包含恰好落在目标位置的事务,默认是包含。命名恢复点则以该标记为停止位置,不使用这个包含性开关来决定“前一笔还是后一笔”。
验证正确后结束恢复
如果暂停点正是你要的状态,可恢复 WAL 重放并让这次目标恢复结束。下面命令先解除由恢复目标触发的暂停,再等待实例离开恢复状态。
set -euo pipefail
PORT="<PORT>"
psql -X -p "$PORT" -c "SELECT pg_wal_replay_resume();" >/dev/null
until [[ "$(psql -AtX -p "$PORT" -c "SELECT pg_is_in_recovery()")" == "f" ]]; do
sleep 1
done
echo "recovery complete"预期输出
recovery complete恢复结束后实例会进入新的时间线。如果暂停点不是目标状态,先停止实例:想改到更晚的目标,可以修改恢复目标后继续;想回到更早的目标,则必须重新从基础备份起点开始,因为已经重放过的 WAL 不能靠“倒放”撤销。生产接管前还应完成连接入口、权限、归档策略和备份基线的重新确认。