跳转到主要内容

wal_receiver_create_temp_slot

wal_receiver_create_temp_slot:未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。它是 PG13–18 的 sighup 参数;最新实测启动默认值为 off。
说明

Fact — 官方简述译文:未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。

身份

类型 , bool
上游 pg_settings 类型
Context , sighup
配置 reload 后生效
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 ,
非枚举类型记为 —
分类 , Replication / Standby Servers
上游分类
最后 boot 值 , off
off

生命周期

Fact
首次观测 PG13
在档版本 PG13–19 Beta 3
移除版本
引入提交 329730827848 — walreceiver uses a temporary replication slot by default
提交日期 2020-01-14
Discussion 讨论 1

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG13–19 Beta 3 off off

机制详解

未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。重新加载配置即可应用新值;已经开始的工作不会被追溯改变。

primary_slot_name 为空时,receiver 可为连接生命周期创建上游临时槽。它能防止连接期间删除 WAL,但断连即消失,无法保证长时间中断后的追赶。

应把 wal_receiver_create_temp_slot 与 primary_slot_name、max_replication_slots、max_slot_wal_keep_size 一起监控和变更。先在对应角色与真实负载上验证,再按其 sighup context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 按主备拓扑、故障切换角色、复制槽/订阅数量与断连余量规划 wal_receiver_create_temp_slot;上线前验证主库写延迟、备库重放和磁盘保留的最坏情况。
OLAP 读备库与逻辑订阅常有长查询或大事务,应给重放/应用留明确上界,并监控延迟、worker 饱和、槽 restart_lsn 与冲突取消。
小规格 只配置真实需要的复制能力。少量节点也应设置有界超时与槽生命周期,不要用无限保留换取表面稳定。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG19 Beta 3 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG13–19 Beta 3 未修改;OLAP: PG13–19 Beta 3 未修改;CRIT: PG13–19 Beta 3 未修改;TINY: PG13–19 Beta 3 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

  • 在错误的主库、备库、发送端或订阅端角色上修改。
  • 只看字节/时间配置,不监控真实复制延迟、槽位置与 worker 状态。
  • 故障切换后新主库缺少与旧主库一致的容量或依赖。
  • 用无限等待或无限 WAL 保留掩盖失效消费者。

primary_slot_name · max_replication_slots · max_slot_wal_keep_size · wal_keep_size · hot_standby · hot_standby_feedback

参考资料