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。

bash
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();"

预期输出

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

启动日志中的点号数量和等待时间可能不同。若最后返回 f,说明该实例已经不在 recovery 中,不能把它当作当前主库的普通物理备库继续验证。

从两端检查复制进程

流复制健康时,主库通常能看到对应的 WAL sender,备库能看到一个 WAL receiver。先在主库查询 pg_stat_replication,关注 state 以及发送、写入、刷盘、回放位置。

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

预期结果

text
 application_name |   state   | sent_lsn | write_lsn | flush_lsn | replay_lsn
------------------+-----------+----------+-----------+-----------+-----------
 <VALUE>          | streaming | <LSN>    | <LSN>     | <LSN>     | <LSN>

再到备库查询 WAL receiver 与本地接收、回放位置。

sql
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;

预期结果

text
  status   | sender_host | sender_port | flushed_lsn
-----------+-------------+-------------+-------------
 streaming | <IP>        | <PORT>      | <LSN>

 receive_lsn | replay_lsn
-------------+------------
 <LSN>       | <LSN>

receive_lsn 表示流复制已经接收并同步到磁盘的位置,replay_lsn 表示恢复进程已经应用到的位置。两者不要求每一瞬间完全相等;持续写入期间存在短暂差距是正常现象,关键是它们继续前进且差距不会无界增长。

主库 WAL 发送到备库并经过接收、刷盘和回放的验证链路

用测试写入验证端到端回放

只看进程状态还不够。最直接的验收是让主库产生一个确定的事务,然后在备库查询同一行。以下 SQL 先在主库执行,创建独立测试表并写入固定键值。

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;

预期结果

text
CREATE TABLE
INSERT 0 1
 primary_lsn
-------------
 <LSN>

随后在备库查询。异步复制可能需要极短等待;如果首次未看到记录,稍后重试,而不是立即判定失败。

sql
SELECT probe_id, payload
FROM replication_probe
WHERE probe_id = 2026090701;

SELECT pg_last_wal_replay_lsn() AS standby_replay_lsn;

预期结果

text
  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、两端复制进程存在、接收与回放位置持续推进,并且主库提交的测试事务最终能在备库查询到。

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

目录与阅读设置

阅读设置

17

记录一个想法

启动并验证流复制

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

登录哪都通