PostgreSQL / 系统课时

流复制原理与搭建

流复制原理与搭建

本节从一套最小主备环境出发,完成物理流复制配置,并用系统视图确认 WAL 已经经历“主库发送、备库接收、落盘与重放”完整链路。完成后,你能判断复制是没连上、只收到但没重放,还是已经稳定追平。

学习目标

  • 理解 WAL Sender、WAL Receiver 与重放进程在流复制中的职责
  • 完成主库授权、基础备份与备库启动
  • 使用 pg_stat_replication 和恢复函数验证发送、接收、重放状态

先看清 WAL 如何到达备库

物理流复制复制的不是 SQL,而是主库产生的 WAL。主库的 WAL Sender 持续把 WAL 记录发送给备库;备库 WAL Receiver 接收后写入本地 WAL,随后恢复进程按顺序重放这些记录,使数据页逐步逼近主库状态。

PostgreSQL 流复制中的 WAL 发送、接收与重放链路

当 sent_lsn、write_lsn、flush_lsn、replay_lsn 逐步接近时,说明链路正在追平;如果某一位置长期不动,就可以把故障范围缩小到对应阶段。

配置主库允许复制

主库至少要启用 replica 级别 WAL,并允许足够数量的 WAL Sender。下面是 postgresql.conf 的最小配置片段;修改后需要重启主库,因为这些参数属于启动级参数。

ini
wal_level = replica
max_wal_senders = 10
max_replication_slots = 10

在主库创建专用复制账号:

sql
CREATE ROLE repl_user
WITH REPLICATION LOGIN PASSWORD '<REPL_PASSWORD>';

预期输出:

text
CREATE ROLE

然后在主库 pg_hba.conf 放行备库地址。下面的 <STANDBY_IP>/32 只代表单台备库,实际网段请按部署环境收紧。

text
host    replication    repl_user    <STANDBY_IP>/32    scram-sha-256

配置生效后,重载 pg_hba.conf;而 wal_level、max_wal_senders 等启动级参数必须通过重启实例生效。不要用 trust 代替认证来省略密码。

用基础备份初始化备库

先停止备库 PostgreSQL,并确保目标数据目录为空。随后从备库主机执行 pg_basebackup;把占位符替换为实际主库地址、端口和数据目录。

bash
PGPASSWORD='<REPL_PASSWORD>' pg_basebackup \
  -h '<PRIMARY_IP>' \
  -p '<PORT>' \
  -U repl_user \
  -D '<STANDBY_DATA_PATH>' \
  -Fp -Xs -P -R

预期输出:

text
<VALUE>/<VALUE> kB (100%), 1/1 tablespace

进度中的字节数会随数据量变化。-Xs 在备份期间同步流式获取所需 WAL;在 PostgreSQL 12 及以上,-R 会创建 standby.signal,并写入连接主库所需的 primary_conninfo。

用同一数据目录启动备库:

bash
pg_ctl -D '<STANDBY_DATA_PATH>' start

预期输出:

text
waiting for server to start... done
server started

如果实例由 systemd、容器编排或云平台托管,应改用对应的启动方式;核心要求是让该数据目录以 standby 模式启动。

验证发送、接收与重放

先在主库查询复制连接。最关键的是 state 应为 streaming;默认异步复制下,sync_state 通常为 async。

sql
SELECT
  application_name,
  client_addr,
  state,
  sync_state,
  sent_lsn,
  write_lsn,
  flush_lsn,
  replay_lsn
FROM pg_stat_replication;

预期结果:

text
 application_name | client_addr |   state   | sync_state | sent_lsn | write_lsn | flush_lsn | replay_lsn
------------------+-------------+-----------+------------+----------+-----------+-----------+-----------
 <APP_NAME>       | <IP>        | streaming | async      | <VALUE>  | <VALUE>   | <VALUE>   | <VALUE>

再到备库确认它处于恢复状态,并已经收到、重放 WAL:

sql
SELECT
  pg_is_in_recovery() AS in_recovery,
  pg_last_wal_receive_lsn() AS received,
  pg_last_wal_replay_lsn() AS replayed;

预期结果:

text
 in_recovery | received | replayed
-------------+----------+---------
 t           | <VALUE>  | <VALUE>

健康链路中,received 与 replayed 会持续前进;空值通常意味着尚未接收到流式 WAL,长期差距扩大则表示重放速度跟不上接收速度。

断点应该从哪一侧查

主库没有 pg_stat_replication 行时,先检查网络、端口、pg_hba.conf、复制账号和密码;有连接但不是 streaming 时,再看主备日志中的认证、时间线或 WAL 缺失错误。主库视图正常而备库 replayed 长期不前进,则重点检查备库磁盘、恢复冲突和资源瓶颈。

生产环境还要考虑 WAL 保留策略。物理复制槽可以防止主库过早删除备库尚未消费的 WAL,但掉线备库也可能让主库 WAL 无限堆积,因此必须同时监控复制槽滞留量与磁盘空间。

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

目录与阅读设置

阅读设置

17

记录一个想法

流复制原理与搭建

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

登录哪都通