跳转到主要内容

max_slot_wal_keep_size

在检查点时限制复制槽可保留 WAL 大小的可重载参数。本目录从 PG13 起收录，默认 -1（无限制）；Pigsty 使用有限的磁盘比例上限。
说明

Fact — 官方简述译文：设置复制槽可保留的 WAL 最大大小。

身份

类型 值integer
上游 pg_settings 类型
Context 值sighup
配置 reload 后生效
单位 值MB
原始单位
范围 值-1 – 2147483647
最后在档版本的原始上下限
枚举值 值—
非枚举类型记为 —
分类 值Replication / Sending Servers
上游分类
最后 boot 值 值-1
-1 MB

生命周期

Fact 值
首次观测 PG13
在档版本 PG13–19 Beta 3
移除版本 否
引入提交 c6550776394e — Allow users to limit storage reserved by replication slots
提交日期 2020-04-07
Discussion 讨论 1

默认值变迁

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

机制详解

执行检查点时，PostgreSQL 会比较复制槽的 restart_lsn 与当前 WAL 位置。默认值 -1 表示参数不设上限，因此停滞消费者可能保留足以写满 pg_wal 的 WAL。

设置有限值后，复制槽落后过多时所需段可被释放。槽的 wal_status 可能从 unreserved 变为 lost，消费者可能需要重新做基础备份或逻辑同步。该上限通过牺牲无限期可续传保证来保护主库磁盘。

限制在检查点时执行，因此既不即时，也不是精确字节硬上限。pg_replication_slots 提供 restart_lsn、wal_status、invalidation_reason 和 safe_wal_size，应在触顶前使用这些信号预警。

调优建议

提示

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

场景 建议
OLTP 在 pg_wal 应急预算内设置有限值，并按峰值 WAL 速率乘以最大修复窗口推导。safe_wal_size 仍为正时就应告警，并为每个消费者记录重新同步路径。
OLAP 为预期的批量 WAL 峰值留出空间，但不要让上限形同无限。协调消费者与批任务，验证归档可用性，并在落后消费者耗尽磁盘预算之前暂停或修复它。
小规格 采用更严格的有限上限和较短修复目标。小卷环境通常应优先保护主库，而不是永远保证陈旧备库或 CDC 槽可续传。

Pigsty 取值

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

模板 有效值 与上游 boot 比较 源表达式
OLTP 30GB 不同于 boot 值 {{ ([pg_size_twentieth * 6, 3000])|min }}GB
OLAP 30GB 不同于 boot 值 {{ ([pg_size_twentieth * 6, 3000])|min }}GB
CRIT 30GB 不同于 boot 值 {{ ([pg_size_twentieth * 6, 3000])|min }}GB
TINY 30GB 不同于 boot 值 {{ ([pg_size_twentieth * 6, 3000])|min }}GB
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG13–19 Beta 3 = 30GB (dcs)；OLAP: PG13–19 Beta 3 = 30GB (dcs)；CRIT: PG13–19 Beta 3 = 30GB (dcs)；TINY: PG13–19 Beta 3 = 30GB (dcs)。 建议（待人工复核）——发布前应结合当前 Pigsty 模板及其实际支持的 PostgreSQL 版本确认运维意图。

常见坑

  • 保留 -1，却认为停滞复制槽不会写满磁盘。
  • 把有限值当作即时硬上限，忽略检查点执行时机。
  • 设置过小，在计划内批量任务期间使健康消费者失效。
  • 认为所需 WAL 删除后消费者仍必然可以续传。
  • 把该复制槽保留上限与 wal_keep_size 保留下限混淆。

max_replication_slots · wal_keep_size · max_wal_size · idle_replication_slot_timeout · checkpoint_timeout · archive_mode

参考资料

最后修改 2026-09-11