PostgreSQL / 系统课时

配置源库逻辑复制参数

配置源库逻辑复制参数

源库只有在 WAL 能输出逻辑变更、复制槽有容量、WAL Sender 有连接名额时,才能稳定承担发布端角色。本课完成参数容量估算、写入、重启验证,并用一个短生命周期逻辑槽确认 logical decoding 真正可用。

学习目标

  • 理解 wal_level、max_replication_slots 与 max_wal_senders 的职责和容量关系
  • 在源库写入逻辑复制参数,并判断修改是否仍等待重启
  • 创建并清理测试逻辑槽,验证源实例能够输出逻辑 WAL

先算容量再改参数

wal_level 必须为 logical。max_replication_slots 要覆盖计划中的订阅槽,并为初始化同步等场景保留余量;max_wal_senders 还要同时容纳逻辑复制连接和现有物理复制连接。

例如计划 4 个订阅,预留 4 个槽位,并且当前还有 2 个物理副本,可以先采用 max_replication_slots = 8、max_wal_senders = 10 作为起点。生产值应根据现有槽、并发迁移任务和物理复制连接重新核算,而不是照抄示例。

写入源库参数

自管 PostgreSQL 可以修改 postgresql.conf,也可以由具备权限的管理员使用 ALTER SYSTEM。下面示例会写入 postgresql.auto.conf;托管数据库如果禁止该命令,应在云平台的参数组中设置同名参数。

sql
ALTER SYSTEM SET wal_level = 'logical';
ALTER SYSTEM SET max_replication_slots = '8';
ALTER SYSTEM SET max_wal_senders = '10';

预期输出

text
ALTER SYSTEM
ALTER SYSTEM
ALTER SYSTEM

这三个核心参数都属于需要服务器启动时确定的配置。写入后必须按你的部署方式重启 PostgreSQL;仅执行配置 reload 不能让它们全部生效。

重启后验证生效状态

重启完成后查询 pg_settings。除了看最终值,还要检查 pending_restart,避免参数文件已经改了,但进程仍运行在旧配置上。

sql
SELECT name, setting, context, pending_restart
FROM pg_settings
WHERE name IN (
    'wal_level',
    'max_replication_slots',
    'max_wal_senders'
)
ORDER BY name;

预期输出

text
name                  | setting | context    | pending_restart
max_replication_slots | 8       | postmaster | f
max_wal_senders       | 10      | postmaster | f
wal_level             | logical | postmaster | f

如果 wal_level 仍不是 logical,或 pending_restart 为 t,不要继续创建正式订阅。先确认修改的是当前实例实际读取的配置来源,并完成一次有效重启。

用逻辑槽做能力探针

参数看起来正确还不够,最直接的验证是创建一个使用内置 pgoutput 插件的短生命周期逻辑槽。测试槽会真实占用复制槽并可能保留 WAL,因此验证完立即删除。

sql
SELECT slot_name, lsn
FROM pg_create_logical_replication_slot(
    'migration_probe',
    'pgoutput'
);

SELECT slot_name, plugin, slot_type, active
FROM pg_replication_slots
WHERE slot_name = 'migration_probe';

SELECT pg_drop_replication_slot('migration_probe');

预期输出

text
slot_name       | lsn
migration_probe | <LSN>

slot_name       | plugin   | slot_type | active
migration_probe | pgoutput | logical   | f

pg_drop_replication_slot

(1 row)

LSN 会随实例当前 WAL 位置变化。创建成功说明 logical decoding 与复制槽机制已经可用;删除后再查询 pg_replication_slots 不应残留 migration_probe。

防止复制槽把 WAL 留满磁盘

逻辑槽会阻止仍被订阅端需要的 WAL 被回收。迁移期间如果订阅停止消费,源库磁盘可能持续增长,所以“参数配置完成”还必须配套监控槽位积压。

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

预期输出

text
slot_name | active | restart_lsn | retained_wal
<SLOT>    | <BOOL> | <LSN>       | <VALUE>

retained_wal 持续增长且槽长期不活跃时,应先排查订阅连接和消费进度,再决定是否处理槽,不能直接删除正在承担迁移的正式槽。到这里,源库应同时满足参数已生效、逻辑槽可创建、测试槽已清理以及 WAL 积压可观测四个条件,才适合进入正式 publication 和 subscription 配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置源库逻辑复制参数

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

登录哪都通