PostgreSQL 16时间点恢复:基础备份与WAL

PostgreSQL时间点恢复需要物理基础备份和连续WAL归档,pg_dump逻辑备份不能直接接上WAL前滚。本文针对PostgreSQL 16、没有额外表空间、备份后没有时间线切换的场景,在独立恢复机演练整个集群。示例使用Ubuntu程序目录/usr/lib/postgresql/16/bin,系统账号和数据库管理角色均为postgres;其他布局先替换实际路径及身份。

先确认恢复材料

  1. 基础来自可验证的物理备份流程,保留backup_label、清单及源实例配置,不能用运行中随手复制的数据目录替代。
  2. WAL从基础需要的起点连续保存,覆盖目标,并足以让服务器判定到达目标;保留需要的时间线历史文件。
  3. 目标晚于基础备份结束时刻,否则选更早备份。根据事务提交与业务证据审定目标,不能只拿一条SQL的开始时间代替。
  4. 恢复机使用兼容的PostgreSQL 16程序及必要扩展,隔离生产连接、邮件、支付、队列和扩展定时任务。

保存原实例及原始备份,下面只操作恢复副本。物理恢复包含全部库和角色,逻辑恢复另见PostgreSQL备份与恢复验证。

使用新的数据目录和独立配置

按原备份格式展开到全新的/srv/pg-recovery-20261115,WAL副本放到/srv/wal-archive。确认属主、权限及所有绝对路径,不得指向生产,也不能带有指向生产的符号链接。表空间或外部数据目录需要另外设计映射,不能套本简化示例。

以下数据库工具由隔离机的postgres系统账号执行。带backup_manifest的普通格式备份,先在修改任何恢复配置前检查:

/usr/lib/postgresql/16/bin/pg_verifybackup /srv/pg-recovery-20261115

若所需WAL另存归档目录,按备份工具说明通过--wal-directory指定完整目录。检查通过只证明相应备份检查通过,不代表已达到恢复目标。

由管理账号提前新建/srv/pg-recovery-conf和/srv/pg-recovery-socket,属主postgres、权限700,已有同名目录就换新路径。把源主配置及必要include复制到独立配置目录逐项审定,保留恢复所需的资源和扩展参数;部分恢复参数必须不低于源实例要求,不能随意改成一份最小默认配置。

处理auto.conf覆盖,并设置恢复参数

postgresql.auto.conf中的设置会覆盖postgresql.conf。先审阅恢复副本中的auto.conf,把需要保留的配置合并到演练主配置,去掉生产连接、原归档动作及外发任务。在恢复副本仍未启动、备份完整性已检查且新配置已审定后,保留该文件副本,再建立空的auto.conf:

(
  set -e
  umask 077
  test ! -L /srv/pg-recovery-20261115/postgresql.auto.conf
  test ! -e /srv/pg-recovery-conf/postgresql.auto.conf.source
  if test -f /srv/pg-recovery-20261115/postgresql.auto.conf; then
    cp -p /srv/pg-recovery-20261115/postgresql.auto.conf \
      /srv/pg-recovery-conf/postgresql.auto.conf.source
  fi
  : > /srv/pg-recovery-20261115/postgresql.auto.conf
)

在本次专用的/srv/pg-recovery-conf/postgresql.conf中合并以下参数,不能在后续include里又覆盖它们。时间仅为格式示例,应替换成审定目标;其他类型的恢复目标必须清除:

data_directory = '/srv/pg-recovery-20261115'
hba_file = '/srv/pg-recovery-conf/pg_hba.conf'
ident_file = '/srv/pg-recovery-conf/pg_ident.conf'
external_pid_file = ''
listen_addresses = ''
port = 55432
unix_socket_directories = '/srv/pg-recovery-socket'
ssl = off
log_directory = 'log'
hot_standby = on
archive_mode = off
primary_conninfo = ''
primary_slot_name = ''
archive_cleanup_command = ''
recovery_end_command = ''
restore_command = 'cp /srv/wal-archive/%f "%p"'
recovery_target_time = '2026-11-15 10:23:00+08'
recovery_target_inclusive = false
recovery_target_timeline = 'current'
recovery_target_action = 'pause'

在专用pg_hba.conf中仅放local all postgres peer,并准备空的pg_ident.conf。套接字目录700只供恢复账号访问;listen_addresses为空不开放TCP,因此这里不需要TLS监听。若身份命名不同,应先配置正确的peer映射,不能改成全网trust。

restore_command找不到文件必须返回失败。current沿基础备份时间线恢复,存在切换历史时应另行审定。inclusive=false不包含目标边界事务,最后仍要用日志与记录确认是否停在错误事务之前。

显式指定配置启动,不只依赖-D

data_directory能覆盖-D的数据位置,Ubuntu的主配置也常在数据目录外。启动前用相同参数查询有效路径;下面不会启动数据库:

/usr/lib/postgresql/16/bin/postgres \
  -D /srv/pg-recovery-20261115 \
  -c config_file=/srv/pg-recovery-conf/postgresql.conf \
  -c data_directory=/srv/pg-recovery-20261115 \
  -C data_directory

用相同命令分别把-C后的名称换为config_file、hba_file、listen_addresses和restore_command,逐项核对。确认恢复副本没有standby.signal,且所有路径和动作只属于本次演练,再执行:

touch /srv/pg-recovery-20261115/recovery.signal
/usr/lib/postgresql/16/bin/pg_ctl \
  -D /srv/pg-recovery-20261115 \
  -o "-c config_file=/srv/pg-recovery-conf/postgresql.conf -c data_directory=/srv/pg-recovery-20261115" \
  -l /srv/pg-recovery-20261115/recovery.log start

缺少必要WAL、校验失败或“未到达目标就结束”时保留日志排查,不能删除recovery.signal强行启动。个别不存在的历史文件请求可能正常,但不能一概忽略所有缺文件错误。

确认paused,再只读验收

psql -h /srv/pg-recovery-socket -p 55432 -U postgres -d postgres -c "SELECT pg_is_in_recovery(),pg_get_wal_replay_pause_state(),pg_last_xact_replay_timestamp();"

确认仍在恢复且状态为paused,并核对日志中的停止点。最后重放事务时间只是辅助信息,不要求与目标时间字面相等。只读检查错误事务未生效、所需记录仍在,以及关联数据正确;不要为了能写入就立即继续恢复或提升实例。

目标不正确时从保留材料重新演练。恢复点正确后可隔离导出所需数据,正式接管还须处理目标之后的合法新增数据与写入归属。本教程的完成标准是隔离集群停在已核实的目标,不等于生产切换完成。