PostgreSQL / 系统课时

配置物理复制槽

配置物理复制槽

物理复制槽能为短暂断线的备库保留仍可能需要的 WAL,但它不是无条件、无限期的保护。本课完成槽创建、备库绑定和状态验证,并结合 restart_lsn、wal_status、safe_wal_size 判断 WAL 是否仍受槽保护以及槽是否存在失效风险。

学习目标

  • 创建物理复制槽,并让流复制备库通过指定槽接收 WAL。
  • 结合 active、restart_lsn、wal_status 和 safe_wal_size 判断槽的使用与 WAL 可用状态。
  • 理解 max_slot_wal_keep_size 如何限制 WAL 保留,并识别 unreserved、lost 状态的影响。

创建并检查物理复制槽

在主库上使用具备复制槽管理权限的账号创建 standby1_slot。第二个参数 true 表示立即为物理槽预留 WAL,使备库尚未连接时也能建立明确的 restart_lsn。

sql
SELECT slot_name, lsn
FROM pg_create_physical_replication_slot('standby1_slot', true);

SELECT slot_name,
       slot_type,
       active,
       restart_lsn,
       wal_status,
       safe_wal_size
FROM pg_replication_slots
WHERE slot_name = 'standby1_slot';

预期结果:

text
  slot_name    |   lsn
---------------+---------
 standby1_slot | <LSN>
(1 row)

  slot_name    | slot_type | active | restart_lsn | wal_status | safe_wal_size
---------------+-----------+--------+-------------+------------+---------------
 standby1_slot | physical  | f      | <LSN>       | reserved   | NULL
(1 row)

以上第二组结果假定 max_slot_wal_keep_size 仍为默认值 -1,因此 safe_wal_size 为 NULL;如果已经设置有限值,这一列可能显示具体字节数。active = f 表示当前没有复制连接使用该槽。

restart_lsn 是槽消费者仍可能需要的最早 WAL 位置,但不能把它理解为任何情况下都不会被回收的绝对边界。若配置了有限的 max_slot_wal_keep_size,槽落后过多时,检查点仍可能允许所需 WAL 被移除,必须结合 wal_status 判断实际可用性。

让备库使用复制槽

在备库的 postgresql.conf 中配置主库连接,并通过 primary_slot_name 绑定复制槽。下面是片段示例,依赖已经初始化完成的物理备库、可用复制账号以及相应的密码文件或其他认证配置。

text
primary_conninfo = 'host=<PRIMARY_HOST> port=<PORT> user=<REPL_USER> application_name=standby1'
primary_slot_name = 'standby1_slot'

配置生效并启动 WAL receiver 后,在主库执行下面这组状态查询。它也可以作为后续观察备库失联和恢复时的主查询。

sql
SELECT slot_name,
       active,
       active_pid,
       restart_lsn,
       wal_status,
       safe_wal_size,
       pg_size_pretty(
         pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)
       ) AS retained_gap
FROM pg_replication_slots
WHERE slot_name = 'standby1_slot';

预期结果:

text
  slot_name    | active | active_pid | restart_lsn | wal_status | safe_wal_size | retained_gap
---------------+--------+------------+-------------+------------+---------------+-------------
 standby1_slot | t      | <PID>      | <LSN>       | reserved   | <VALUE>       | <VALUE>
(1 row)

active = t 表示复制连接正在使用该槽,active_pid 是主库对应 walsender 的进程 PID。retained_gap 是当前 WAL 位置与 restart_lsn 的 LSN 差值,可用于观察落后趋势,但它不等于 pg_wal 目录的精确磁盘占用量。若 max_slot_wal_keep_size = -1,这里的 safe_wal_size 会显示 NULL。

读懂 WAL 保留状态

wal_status 比单独观察 restart_lsn 更直接地回答“槽声明需要的 WAL 现在是否仍受保护”。生产排查时应优先把二者结合起来判断。

状态 含义 运维判断
reserved 槽声明需要的 WAL 仍在正常保留范围内 可继续复制
extended WAL 保留已经超过常规 max_wal_size,但仍因复制槽或 wal_keep_size 等原因保留 WAL 仍可用,但应关注增长
unreserved 槽已经不再保证保留全部所需 WAL,部分文件可能在后续检查点被移除 已进入危险状态,但在文件实际丢失前状态仍可能恢复
lost 槽所需 WAL 已无法完整获得,槽本身不再可用 必须处置并重新建立可用复制路径

safe_wal_size 表示在当前状态和有限的 max_slot_wal_keep_size 下,还能写入多少字节 WAL 而不至于让槽面临进入 lost 的危险。槽已经 lost,或者 max_slot_wal_keep_size = -1 时,该值为 NULL。

物理复制槽与 WAL 保留关系

观察备库失联后的变化

停止备库后再次执行前面的状态查询,active 会变为 f。如果主库继续产生 WAL,而备库没有消费,restart_lsn 会停留在较早位置,retained_gap 通常持续增大。恢复备库并成功追赶后,restart_lsn 才会随着消费者进度向前推进。

如果此时 wal_status 仍为 reserved 或 extended,槽所需 WAL 仍可获得;出现 unreserved 则说明容量限制已经开始威胁槽的保护能力。不能仅看到 restart_lsn 仍存在,就断言该位置之后的 WAL 一定不会被清理。

控制复制槽失效风险

可以通过 max_slot_wal_keep_size 限制复制槽在检查点时允许保留的 WAL 规模。例如在主库 postgresql.conf 中设置:

text
max_slot_wal_keep_size = '20GB'

这是配置片段。修改后需要让配置重新加载,并确认服务器实际读取到目标值:

sql
SELECT pg_reload_conf();
SHOW max_slot_wal_keep_size;

预期结果:

text
 pg_reload_conf
----------------
 t
(1 row)

 max_slot_wal_keep_size
------------------------
 20GB
(1 row)

限制值是在检查点处理 WAL 回收时发挥作用,并不意味着磁盘占用会始终精确封顶在 20GB。当槽的 restart_lsn 相对当前 WAL 位置落后过多时,wal_status 可能先进入 unreserved;如果需要的 WAL 随后实际被移除,槽会进入 lost,此时该槽不能继续用于复制。

槽进入 lost 后,备库能否继续恢复取决于缺失 WAL 是否还能从 WAL 归档等其他来源取得;如果缺失 WAL 已不可获得,就需要从新的可用基线重新建立备库。生产监控因此应同时覆盖槽活跃状态、restart_lsn 推进速度、wal_status、safe_wal_size、WAL 磁盘占用和备库失联时长,而不能把复制槽本身当作无限期 WAL 保险。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置物理复制槽

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

登录哪都通