PostgreSQL / 系统课时

搭建 PostgreSQL 18 恢复实验环境

搭建 PostgreSQL 18 恢复实验环境

这一课搭建一个不会碰生产数据的 PostgreSQL 18 PITR 实验台:创建独立主库、基础备份目录、WAL 归档目录和恢复目录,开启归档并验证 WAL 能真正离开主库。后续备份、误删和时间点恢复都可在这套目录中重复演练。

学习目标

  • 创建彼此隔离的主库、备份、归档和恢复目录,并明确每个目录的职责。
  • 配置 PostgreSQL 18 的 wal_level、archive_mode 与 archive_command,让 WAL 具备连续归档条件。
  • 通过版本、参数和 pg_stat_archiver 验证环境已达到后续 PITR 实验的最低要求。

先确认工具与隔离边界

以下示例面向 Linux 或 macOS shell,并假设 PostgreSQL 18 的 postgres、initdb、pg_ctl、psql 已在 PATH 中。实验目录放在当前用户家目录下,主库和后续恢复实例都使用非默认端口,避免误连本机已有实例。执行前先确认命令确实来自 PostgreSQL 18。

bash
postgres --version
initdb --version
psql --version

预期输出的三个主版本都应为 18;补丁版本可能不同。

text
postgres (PostgreSQL) 18.<VALUE>
initdb (PostgreSQL) 18.<VALUE>
psql (PostgreSQL) 18.<VALUE>

如果出现 command not found,先把 PostgreSQL 18 的 bin 目录加入 PATH。如果显示 17 或更早版本,不要继续初始化目录,否则后续实验会混用不同主版本的数据目录和工具。

建立四类实验目录

实验拓扑只保留一个正在运行的主库。basebackup 用来放物理基础备份,archive 接收已完成的 WAL 段,restore 预留给未来从基础备份还原出的恢复实例,并预留独立端口 55433;不要提前在 restore 中执行 initdb,因为真正恢复时这里应由备份内容填充。

PostgreSQL 18 PITR 实验环境目录与数据流

先创建目录并初始化主库。示例端口为 55432 和 55433,如果本机已占用,应改成其他空闲端口;实际路径也会随用户家目录不同而变化。

bash
set -euo pipefail

export LAB_ROOT="$HOME/pg18-pitr-lab"
export PRIMARY_DATA="$LAB_ROOT/primary"
export BACKUP_DIR="$LAB_ROOT/basebackup"
export ARCHIVE_DIR="$LAB_ROOT/archive"
export RESTORE_DATA="$LAB_ROOT/restore"
export PRIMARY_PORT=55432
export RESTORE_PORT=55433

rm -rf "$LAB_ROOT"
install -d -m 700 \
  "$PRIMARY_DATA" \
  "$BACKUP_DIR" \
  "$ARCHIVE_DIR" \
  "$RESTORE_DATA"

initdb -D "$PRIMARY_DATA" --encoding=UTF8 --no-locale

预期输出末尾会提示数据库集群初始化成功,并给出启动命令;路径中的用户名等实际值可能不同。

text
Success. You can now start the database server using:

    pg_ctl -D <PATH> -l logfile start

rm -rf "$LAB_ROOT" 只适用于可丢弃实验目录。不要把 LAB_ROOT 指向任何现有 PostgreSQL 数据目录、生产备份目录或共享归档目录。

开启 WAL 归档并启动主库

PITR 需要足够的 WAL 信息,因此保持 wal_level = replica 或更高,并开启 archive_mode。实验环境用一个小脚本复制完成的 WAL 段:同名文件已经存在时,只有内容完全一致才返回成功,避免静默覆盖不同来源的 WAL。

bash
cat > "$LAB_ROOT/archive_wal.sh" <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail

src="$1"
name="$2"
archive_dir="$3"
dest="$archive_dir/$name"

# 同名归档只能复用内容完全一致的文件。
if [ -f "$dest" ]; then
  cmp -s "$src" "$dest"
  exit $?
fi

tmp="$dest.tmp.$$"
cp "$src" "$tmp"
mv "$tmp" "$dest"
SCRIPT

chmod 700 "$LAB_ROOT/archive_wal.sh"

cat >> "$PRIMARY_DATA/postgresql.conf" <<EOF
port = $PRIMARY_PORT
listen_addresses = 'localhost'
wal_level = replica
archive_mode = on
archive_command = '$LAB_ROOT/archive_wal.sh "%p" "%f" "$ARCHIVE_DIR"'
EOF

pg_ctl -D "$PRIMARY_DATA" \
  -l "$LAB_ROOT/primary.log" \
  start

psql -h localhost -p "$PRIMARY_PORT" -d postgres -Atqc \
  "SELECT current_setting('server_version'),
          current_setting('wal_level'),
          current_setting('archive_mode');"

预期结果应确认服务器成功启动、主版本为 18、wal_level 为 replica、归档模式为 on。

text
waiting for server to start.... done
server started
18.<VALUE>|replica|on

archive_mode 和 wal_level 都需要在服务器启动时确定;本课直接在首次启动前写入配置,因此不需要额外重启。生产环境的归档脚本还应考虑持久化落盘、容量监控、跨主机存储和告警,不能直接把这个最小实验脚本当成完整生产方案。

验证 WAL 确实进入归档目录

只看到参数为 on 还不够,真正的验收标准是归档器成功处理 WAL。先制造一小段变更,再强制切换当前 WAL 段;随后读取 pg_stat_archiver,并核对归档目录确实出现文件。

bash
psql -h localhost -p "$PRIMARY_PORT" -d postgres <<'SQL'
CREATE TABLE recovery_probe (
    id integer PRIMARY KEY,
    note text NOT NULL
);

INSERT INTO recovery_probe
VALUES (1, 'before-base-backup');

SELECT pg_switch_wal();
SQL

for _ in $(seq 1 100); do
  archived_count="$(
    psql -h localhost -p "$PRIMARY_PORT" -d postgres -Atqc \
      "SELECT archived_count FROM pg_stat_archiver"
  )"
  if [ "$archived_count" -gt 0 ]; then
    break
  fi
  sleep 0.2
done

psql -h localhost -p "$PRIMARY_PORT" -d postgres -c \
  "SELECT archived_count, failed_count, last_archived_wal
   FROM pg_stat_archiver;"

ls -1 "$ARCHIVE_DIR"

预期结果中,archived_count 至少为 1,failed_count 应为 0,last_archived_wal 与归档目录中的某个 WAL 文件名对应。计数和文件名属于动态值。

text
 archived_count | failed_count | last_archived_wal
----------------+--------------+-------------------
 <VALUE>        | 0            | <WAL_FILE>

<WAL_FILE>

如果 failed_count 增长或目录始终为空,先查看 $LAB_ROOT/primary.log,再检查归档目录是否可由启动 PostgreSQL 的用户写入,以及 archive_command 中的路径是否正确。不要继续做基础备份,否则你可能得到一份缺少后续 WAL 的不可恢复实验链路。

验收恢复实验台

最后确认主库可访问、测试数据存在、恢复目录仍为空。恢复目录保持空白很重要:后续会把物理基础备份放进去,再添加恢复配置并用独立端口启动,才能真实演练“从备份基线重放归档 WAL”,而不是从另一个全新集群开始。

bash
psql -h localhost -p "$PRIMARY_PORT" -d postgres -Atqc \
  "SELECT id, note FROM recovery_probe ORDER BY id;"

test -z "$(ls -A "$RESTORE_DATA")"
printf 'restore directory is empty\n'

预期输出如下。

text
1|before-base-backup
restore directory is empty

到这里,环境具备三条可验证边界:主库独立运行、完成的 WAL 能进入独立归档目录、恢复目录尚未被初始化且可留给物理备份。后续做基础备份和 PITR 时,只需要围绕这三条边界继续操作,不必改动本机其他 PostgreSQL 实例。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建 PostgreSQL 18 恢复实验环境

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

登录哪都通