max_replication_slots
Fact — 官方简述译文：设置可同时定义的复制槽最大数量。
身份
生命周期
| Fact | 值 |
|---|---|
| 首次观测 | PG9.4 |
| 在档版本 | PG9.4–19 Beta 3 |
| 移除版本 | 否 |
| 引入提交 | 858ec11858a9 — Introduce replication slots. |
| 提交日期 | 2014-01-31 |
| Discussion | — |
默认值变迁
| 版本 | 原始 boot_val |
单位 | 人类可读值 |
|---|---|---|---|
| PG9.4–9.6 | 0 |
— | 0 |
| PG10–19 Beta 3 | 10 |
— | 10 |
机制详解
PostgreSQL 在服务器启动时分配复制槽控制容量。物理槽可以为备库保留 WAL；逻辑槽还会为解码消费者保留 WAL 和系统目录可见性信息。
该值限制复制槽对象数量，而不是活动 WAL 发送连接数；后者由 max_wal_senders 单独限制。使用复制槽还要求 wal_level 至少为 replica。若将该值降到现有槽数量以下，服务器将无法启动。
没有活动进程的槽也不一定无害。持久的非活动槽可能保留 WAL，逻辑槽还可能持有 catalog_xmin，因此消费者生命周期和槽清单治理与数字上限同样重要。
调优建议
Advice。 以下建议是工作负载起点，必须用真实测量验证。
| 场景 | 建议 |
|---|---|
| OLTP | 按具名物理备库、逻辑订阅、CDC 消费者、备份或迁移工具、故障转移槽及创建余量核算。可保留少量缓冲，但较大上限必须配套所有者、过期和延迟监控。 |
| OLAP | 为逻辑消费者和迁移任务预留空间，同时注意高 WAL 批处理会放大废弃槽的代价。批任务前后应检查 restart_lsn 与 confirmed_flush_lsn。 |
| 小规格 | 将上限保持在真实消费者数量加有限余量附近。大值本身不会保留 WAL，却更容易产生无人治理的槽，在小磁盘上迅速演变为故障。 |
Pigsty 取值
以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具，并按 PG19 Beta 3 渲染当前 Pigsty 模板；这不表示 Pigsty 当前支持该历史或测试版本。
| 模板 | 有效值 | 与上游 boot 比较 | 源表达式 |
|---|---|---|---|
| OLTP | 50 |
不同于 boot 值 | 50 |
| OLAP | 50 |
不同于 boot 值 | 50 |
| CRIT | 50 |
不同于 boot 值 | 50 |
| TINY | 50 |
不同于 boot 值 | 50 |
Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG9.4–19 Beta 3 = 50 (dcs)；OLAP: PG9.4–19 Beta 3 = 50 (dcs)；CRIT: PG9.4–19 Beta 3 = 50 (dcs)；TINY: PG9.4–19 Beta 3 = 50 (dcs)。 建议（待人工复核）——发布前应结合当前 Pigsty 模板及其实际支持的 PostgreSQL 版本确认运维意图。
常见坑
- 把复制槽数量上限与限制并发发送进程的 max_wal_senders 混淆。
- 将值降到现有复制槽数量以下，导致 PostgreSQL 无法启动。
- 认为非活动槽不会保留 WAL 或系统目录旧行版本。
- 提高上限却不监控 restart_lsn、catalog_xmin 和消费者健康。
- 实验时创建永久复制槽，结束后从不删除。
关联参数
max_wal_senders · max_slot_wal_keep_size · wal_level · idle_replication_slot_timeout · max_logical_replication_workers · primary_slot_name
参考资料
- PostgreSQL 19 Beta 3 — max_replication_slots
- PostgreSQL 18：复制槽
- PostgreSQL 18：pg_replication_slots
- PostgreSQL 19 发行说明
- 机器可读 GUC 全量导出