PostgreSQL / 系统课时
启动并验证流复制
启动并验证流复制
本课完成主备环境的第一次端到端验收:启动已初始化的备库,分别从主库和备库检查复制进程与 LSN,再写入一条可识别的测试数据验证 WAL 已被接收并回放。最终要证明的不是“连接存在”,而是主库提交的变化能够持续到达备库。
学习目标
- 启动备库并确认它处于 recovery 状态
- 使用
pg_stat_replication、pg_stat_wal_receiver和 LSN 判断传输与回放是否推进 - 通过主库测试写入与备库只读查询完成端到端复制验证
启动备库并确认角色
假设上一阶段已使用 pg_basebackup -R 准备好 PGDATA,其中存在 standby.signal 和有效的 primary_conninfo。先启动备库,再查询 pg_is_in_recovery();物理备库正常运行时应返回 true。
export STANDBY_PGDATA="<PATH>"
export STANDBY_PORT="<PORT>"
sudo -u postgres pg_ctl -D "${STANDBY_PGDATA}" -w start
psql -p "${STANDBY_PORT}" -d postgres -Atc "SELECT pg_is_in_recovery();"预期输出
waiting for server to start.... done
server started
t启动日志中的点号数量和等待时间可能不同。若最后返回 f,说明该实例已经不在 recovery 中,不能把它当作当前主库的普通物理备库继续验证。
从两端检查复制进程
流复制健康时,主库通常能看到对应的 WAL sender,备库能看到一个 WAL receiver。先在主库查询 pg_stat_replication,关注 state 以及发送、写入、刷盘、回放位置。
SELECT application_name,
state,
sent_lsn,
write_lsn,
flush_lsn,
replay_lsn
FROM pg_stat_replication;预期结果
application_name | state | sent_lsn | write_lsn | flush_lsn | replay_lsn
------------------+-----------+----------+-----------+-----------+-----------
<VALUE> | streaming | <LSN> | <LSN> | <LSN> | <LSN>再到备库查询 WAL receiver 与本地接收、回放位置。
SELECT status, sender_host, sender_port, flushed_lsn
FROM pg_stat_wal_receiver;
SELECT pg_last_wal_receive_lsn() AS receive_lsn,
pg_last_wal_replay_lsn() AS replay_lsn;预期结果
status | sender_host | sender_port | flushed_lsn
-----------+-------------+-------------+-------------
streaming | <IP> | <PORT> | <LSN>
receive_lsn | replay_lsn
-------------+------------
<LSN> | <LSN>receive_lsn 表示流复制已经接收并同步到磁盘的位置,replay_lsn 表示恢复进程已经应用到的位置。两者不要求每一瞬间完全相等;持续写入期间存在短暂差距是正常现象,关键是它们继续前进且差距不会无界增长。

用测试写入验证端到端回放
只看进程状态还不够。最直接的验收是让主库产生一个确定的事务,然后在备库查询同一行。以下 SQL 先在主库执行,创建独立测试表并写入固定键值。
CREATE TABLE IF NOT EXISTS replication_probe (
probe_id bigint PRIMARY KEY,
payload text NOT NULL
);
INSERT INTO replication_probe (probe_id, payload)
VALUES (2026090701, 'streaming-ok')
ON CONFLICT (probe_id)
DO UPDATE SET payload = EXCLUDED.payload;
SELECT pg_current_wal_lsn() AS primary_lsn;预期结果
CREATE TABLE
INSERT 0 1
primary_lsn
-------------
<LSN>随后在备库查询。异步复制可能需要极短等待;如果首次未看到记录,稍后重试,而不是立即判定失败。
SELECT probe_id, payload
FROM replication_probe
WHERE probe_id = 2026090701;
SELECT pg_last_wal_replay_lsn() AS standby_replay_lsn;预期结果
probe_id | payload
------------+--------------
2026090701 | streaming-ok
standby_replay_lsn
--------------------
<LSN>当测试行已可见时,可以确认包含该事务的 WAL 已经被备库回放。若还要比较字节级进度,可分别记录主库写入后的 LSN 与备库回放 LSN;不要用两次相隔较久的采样简单要求数值完全相等,因为主库在采样间可能继续产生新的 WAL。
复制不推进时的定位顺序
如果主库没有 pg_stat_replication 行,优先检查备库的 primary_conninfo、网络、认证和主库 pg_hba.conf。如果备库 pg_stat_wal_receiver 为空,查看备库启动日志通常能直接看到连接失败或 WAL 不可用原因。若 receiver 为 streaming 但 replay_lsn 长时间不推进,则继续检查恢复冲突、I/O 压力和备库日志。
一套可复现主备环境的最低验收标准,就是备库保持 recovery、两端复制进程存在、接收与回放位置持续推进,并且主库提交的测试事务最终能在备库查询到。