PostgreSQL / 系统课时
从备份构建新的可用副本
从备份构建新的可用副本
当需要临时查询历史数据、搭建隔离验证环境或快速补充一个新实例时,优先从已验证的物理备份恢复,比再次从生产主库做全量复制更可控。本课把主数据目录、外部表空间和所需 WAL 作为一个完整备份集恢复,并完成独立实例验收。
学习目标
- 能把已验证的物理备份恢复到新的
PGDATA,并按映射复制和重连外部表空间。 - 能配置归档 WAL 恢复和隔离启动参数,判断实例是否已经结束 recovery。
- 能核对数据目录、表空间位置和基础业务数据,确认新副本可以安全交付。
先明确副本与备份集边界
这里的“新副本”是从物理备份恢复出的独立 PostgreSQL 实例,而不是对生产主库重新执行一次 pg_basebackup。恢复源必须已经通过完整性校验;目标主机应使用与备份相同的 PostgreSQL 大版本。如果启动一致性还依赖归档 WAL,对应 WAL 也必须仍可读取。
plain 格式 pg_basebackup 的外部表空间不属于 PGDATA 普通目录内容:未使用 --tablespace-mapping 时,它们会按源集群的绝对路径写入;使用映射后,PGDATA/pg_tblspc 中的软链接会指向映射后的备份位置。因此恢复新副本时,不能只复制主数据目录,必须同时复制每个外部表空间,并把软链接改到新副本专用目录。
物理备份会携带原集群的数据文件和系统标识。新实例应使用隔离网络或不同端口,避免误接入生产连接池、复制拓扑、归档任务或自动化写入。若备份中的表空间链接仍指向生产路径或共享路径,应先停止恢复并确认真正的备份副本位置,不能直接沿用该链接启动。

恢复主数据目录与表空间
以下主示例假设备份由 plain 格式 pg_basebackup 生成,<PATH>/base/<ID>/data 是主数据目录,并且备份时已通过 --tablespace-mapping 把所有外部表空间放到同一备份集根目录 <PATH>/base/<ID> 之下。脚本会先拒绝任何指向备份集之外的表空间链接,再执行 pg_verifybackup,随后复制 PGDATA、逐个复制表空间并重写 pg_tblspc 软链接。
set -euo pipefail
BACKUP_ROOT="$(readlink -f "<PATH>/base/<ID>")"
BACKUP="$BACKUP_ROOT/data"
PGDATA="<PATH>/clone"
TBLSPC_ROOT="<PATH>/clone-tblspc"
# 恢复目录必须是本次任务的新目录,避免 --delete 误删已有实例。
for dir in "$PGDATA" "$TBLSPC_ROOT"; do
if [[ -e "$dir" ]]; then
echo "refuse existing restore target: $dir" >&2
exit 1
fi
done
# plain 备份中的表空间链接必须指向受控的备份集,而不是生产或共享目录。
while IFS= read -r link; do
src="$(readlink -f "$link")"
case "$src" in
"$BACKUP_ROOT"/*) ;;
*)
echo "refuse tablespace source outside backup set: $src" >&2
exit 1
;;
esac
done < <(find "$BACKUP/pg_tblspc" -mindepth 1 -maxdepth 1 -type l -print)
pg_verifybackup "$BACKUP"
sudo install -d -m 700 -o postgres -g postgres "$PGDATA"
sudo rsync -aH --numeric-ids --delete "$BACKUP/" "$PGDATA/"
sudo chown -R postgres:postgres "$PGDATA"
sudo install -d -m 700 -o postgres -g postgres "$TBLSPC_ROOT"
while IFS= read -r link; do
oid="${link##*/}"
src="$(readlink -f "$link")"
dest="$TBLSPC_ROOT/$oid"
# 每个外部表空间都复制到副本自己的目录,再重写 PGDATA 中的软链接。
sudo install -d -m 700 -o postgres -g postgres "$dest"
sudo rsync -aH --numeric-ids --delete "$src/" "$dest/"
sudo chown -R postgres:postgres "$dest"
sudo rm -f "$PGDATA/pg_tblspc/$oid"
sudo -u postgres ln -s "$dest" "$PGDATA/pg_tblspc/$oid"
echo "restored tablespace oid=$oid -> $dest"
done < <(find "$BACKUP/pg_tblspc" -mindepth 1 -maxdepth 1 -type l -print)预期输出
backup successfully verified
restored tablespace oid=<OID> -> <PATH>/clone-tblspc/<OID><PATH>、<ID> 和 <OID> 需替换为实际值;没有用户表空间时不会出现第二行。pg_verifybackup 只能证明备份与 manifest 一致,不能替代实际恢复演练。如果 plain 备份没有把外部表空间映射到受控备份集内,应先找回并确认那些表空间的备份目录,再按同样原则复制和重连;不要把原生产路径当作新副本的表空间。tar 格式或专有备份仓库则应使用各自的解包或 restore 流程恢复每个表空间。
配置 WAL 并隔离启动
如果基础备份还需要从归档补 WAL,可设置 restore_command 并创建 recovery.signal。以下示例假设 <PATH>/wal 中保存的是可直接复制的未压缩 WAL 段。启动前删除可能遗留的 standby.signal,并用命令行参数关闭归档、清空流复制连接配置,只监听本机独立端口;同时显式覆盖 data_directory,避免继承源集群配置后又指回旧目录。
set -euo pipefail
PGDATA="<PATH>/clone"
WAL_ARCHIVE="<PATH>/wal"
PORT="<PORT>"
sudo -u postgres rm -f "$PGDATA/standby.signal"
sudo -u postgres touch "$PGDATA/recovery.signal"
# 追加的 restore_command 在恢复时从隔离归档目录取 WAL,文件不存在时 cp 返回非零。
printf "%s\n" "restore_command = 'cp $WAL_ARCHIVE/%f %p'" |
sudo -u postgres tee -a "$PGDATA/postgresql.auto.conf" >/dev/null
sudo -u postgres pg_ctl -D "$PGDATA" \
-o "-p $PORT -c data_directory='$PGDATA' -c listen_addresses=127.0.0.1 -c archive_mode=off -c primary_conninfo='' -c primary_slot_name=''" \
-w start预期输出
waiting for server to start.... done
server started<PORT> 应替换为未占用端口。recovery.signal 会让实例进入归档恢复,并在归档 WAL 已全部重放或到达配置的恢复目标后结束 recovery。若日志持续请求某个 WAL 段而无法取得,应检查归档完整性、文件权限和 restore_command 返回码,不要用 pg_resetwal 绕过缺失 WAL。若基础备份已经包含启动到一致点所需的全部 WAL,且不需要继续读取归档,则不必创建 recovery.signal。
验收恢复结果与隔离性
启动成功不等于副本已经可交付。应确认实例已离开 recovery,再核对实际数据目录和所有用户表空间位置,确保它们都落在本次副本的专用路径中。
PORT="<PORT>"
psql -h 127.0.0.1 -p "$PORT" -d postgres -X -v ON_ERROR_STOP=1 <<'SQL'
SELECT pg_is_in_recovery() AS in_recovery,
current_setting('data_directory') AS data_directory;
SELECT spcname,
pg_tablespace_location(oid) AS location
FROM pg_tablespace
WHERE pg_tablespace_location(oid) <> ''
ORDER BY spcname;
SQL若备份包含一个用户表空间,预期结果类似:
in_recovery | data_directory
-------------+----------------
f | <PATH>/clone
(1 row)
spcname | location
--------------+--------------------------------
<TABLESPACE> | <PATH>/clone-tblspc/<OID>
(1 row)实际表空间名称、OID 和路径会不同;没有用户表空间时第二个查询返回 0 行。若 in_recovery 仍为 t,不要把实例当作可写副本交付。最后还应抽查关键数据库、表和可验证业务时间点,并确认监听地址、认证配置、归档设置、监控与定时任务不会影响生产环境。
什么时候优先使用备份恢复
从备份构建新副本适合恢复演练、离线分析、迁移预演和需要反复创建测试实例的场景。它把全量读压力从生产主库转移到备份存储,但副本新鲜度取决于“基础备份时间 + 可用 WAL”;交付前必须明确实际恢复到的时间点,并把主数据目录、全部外部表空间和 WAL 一起纳入验收。