PostgreSQL / 系统课时

读取复制状态与 LSN

读取复制状态与 LSN

判断逻辑复制“走到哪里”,不能只看订阅是否显示为运行中。本课把发布端发送器、逻辑复制槽、订阅端 worker 与 LSN 串成一条观察链,读完后可以用系统视图定位数据是在发送、接收还是应用阶段出现停顿。

学习目标

  • 读懂 pg_stat_replication、pg_replication_slots 与 pg_stat_subscription 的关键字段
  • 用 LSN 的先后关系判断发送、确认与应用进度
  • 根据状态缺口快速区分断连、积压和 WAL 保留风险

先建立 LSN 观察链

LSN 是 WAL 中的位置标记,会随 WAL 写入向前推进。它适合回答“两个复制阶段相差多少 WAL”,但不是时间戳,不能直接把 LSN 差值解释成几秒延迟。

逻辑复制至少要同时看三个位置:发布端当前 WAL 与 walsender 的发送反馈、逻辑复制槽的 confirmed_flush_lsn、订阅端 worker 的接收位置。只看其中一个位置,很容易把“网络没收到”和“已经收到但还没处理”混为一谈。

发布端、复制槽与订阅端之间的 LSN 进度关系

在发布端读取发送器和复制槽

先在发布端执行下面的查询。第一条看当前活跃的 WAL sender 以及订阅端反馈的位置,第二条看逻辑复制槽是否活跃、最早仍需保留的 WAL,以及订阅端已经确认消费到哪里。

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

SELECT
    slot_name,
    active,
    restart_lsn,
    confirmed_flush_lsn,
    pg_size_pretty(
        pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn)
    ) AS wal_gap
FROM pg_replication_slots
WHERE slot_type = 'logical'
ORDER BY slot_name;

预期结果

text
application_name | client_addr | state     | sent_lsn  | write_lsn | flush_lsn | replay_lsn | sync_state
<NAME>           | <IP>        | streaming | <LSN>     | <LSN>     | <LSN>     | <LSN>      | async

slot_name        | active | restart_lsn | confirmed_flush_lsn | wal_gap
<NAME>           | t      | <LSN>       | <LSN>               | <VALUE>

实际名称、地址和 LSN 会不同。state = streaming 说明 sender 正在传输;active = true 说明复制槽当前被消费者占用。confirmed_flush_lsn 是逻辑槽收到的消费确认位置,而 restart_lsn 是该槽仍可能需要的最早 WAL 位置。两者都应持续前移,但含义不同。

这里的 wal_gap 用发布端当前 WAL 减去槽的确认位置,可作为“尚未被该槽确认的 WAL 距离”观察值。它包含整个集群产生的 WAL 位置推进,不等同于某张业务表还差多少行。

在订阅端确认接收进度

再到订阅端读取 pg_stat_subscription。一个订阅可能同时出现主 apply worker 和表同步 worker,因此不要只假设一行结果。

sql
SELECT
    subname,
    pid,
    relid,
    received_lsn,
    latest_end_lsn,
    last_msg_send_time,
    last_msg_receipt_time,
    latest_end_time
FROM pg_stat_subscription
ORDER BY subname, relid NULLS FIRST;

预期结果

text
subname     | pid  | relid | received_lsn | latest_end_lsn | last_msg_send_time | last_msg_receipt_time | latest_end_time
<NAME>      | <PID>|       | <LSN>        | <LSN>          | <TIME>             | <TIME>                | <TIME>

received_lsn 用来观察订阅端收到的 WAL 位置;last_msg_receipt_time 可以判断复制连接最近是否还有消息活动。latest_end_lsn 与 latest_end_time 是协议层的最新结束位置与时间信息,适合辅助判断链路是否持续推进,但不能替代业务数据是否已经可见的验证。

用位置差判断卡在哪一段

判读时按数据流方向逐段比较,而不是先猜参数问题。发布端没有 pg_stat_replication 行,通常先检查订阅是否启用、网络、认证和连接配置;有 sender 但复制槽 active = false,说明当前没有消费者占用该槽。

如果 sent_lsn 持续前移,而订阅端的 received_lsn 长时间不动,优先检查网络、接收端进程和连接稳定性。如果订阅端持续收到消息,但槽的 confirmed_flush_lsn 很久不前移,则需要继续检查 apply worker、目标端锁等待、资源瓶颈或复制错误。

restart_lsn 长时间落后还意味着发布端必须继续保留更老的 WAL。迁移期间应同时监控 pg_wal 空间和槽状态,避免“业务复制还在追平,但发布端先被保留 WAL 撑满磁盘”。

LSN 最有价值的用法不是得到一个孤立数字,而是建立“发送位置 → 接收位置 → 确认位置”的连续证据链。只要这些位置持续前移,就能判断复制还在工作;哪个位置先停止推进,通常就是下一步排查的边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取复制状态与 LSN

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

登录哪都通