CONFIGURATION PARAMETER复制 / 发送服务器
wal_keep_segments
指定在 pg_wal 目录中保留的过去日志文件段的最小数量，以便备库可能需要获取它们来进行流复制。
Sets the number of WAL files held for standby servers.
整数 重载生效 引入 9.0 于 13 移除 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
- 默认值
0- 取值范围
0 – 2147483647- 分类
- 复制 / 发送服务器
- 引入版本
- 9.0
- 状态
- 于 13 移除
版本轨迹
相对 PostgreSQL 11 无变化。
默认值变迁
默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 12。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定在 pg_wal 目录中保留的过去日志文件段的最小数量，以便备库可能需要获取它们来进行流复制。每个段通常为 16 兆字节。如果连接到发送服务器的备库落后超过 wal_keep_segments 个段，发送服务器可能会移除备库仍需要的 WAL 段，在这种情况下，复制连接将被终止。下游连接最终也会因此失败。（但是，如果使用了 WAL 归档，备库可以通过从归档中获取该段来恢复。）
此设置只指定在 pg_wal 中保留的最小段数；系统可能需要为 WAL 归档或从检查点恢复而保留更多段。如果 wal_keep_segments 为零（默认值），系统不会为备库额外保留任何段，因此备库可用的旧 WAL 段数取决于前一个检查点的位置和 WAL 归档的状态。此参数只能在 postgresql.conf 文件中或在服务器命令行上设置。
机制详解
设置为备库保留的 WAL 文件数量。该参数在 PG12 仍存在，并从 PG13 起不再被识别。PostgreSQL 13 用 wal_keep_size 取代按段计数的接口；新参数用字节表示保留下限，不再隐含 WAL 段大小。
它至少为落后备库保留指定数量的旧 WAL 段，因此实际字节数取决于 wal_segment_size。它只是保留下限而非上限，也不能覆盖所有删除条件；PG13 改用 wal_keep_size。
升级前应联合检查 wal_keep_size、wal_segment_size、max_slot_wal_keep_size，从配置、ALTER SYSTEM、角色/数据库设置和自动化模板中删除旧名，并先验证替代机制再启动 PG13+。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
不要在 PG13+ 调优或继续下发 wal_keep_segments。PostgreSQL 13 用 wal_keep_size 取代按段计数的接口；新参数用字节表示保留下限，不再隐含 WAL 段大小。升级前扫描所有配置层并做业务回归。
-
OLAP分析与批处理
迁移方案与 OLTP 相同；另外在长批处理、备库或大对象/扩展工作流中验证新机制，不要假定删除旧开关会保留旧行为。
-
小规格低配实例与开发机
直接删除旧配置并采用受支持替代项；若没有真实兼容需求，不要用脚本伪造旧行为。
常见问题
- 没有乘以 wal_segment_size 就把旧整数直接复制到 wal_keep_size。
- 把保留数量误当上限而非下限。
- PG13+ 自动化中仍保留已移除名称。
- 在 PG13+ 配置中继续下发未知参数 wal_keep_segments。
- 只删除参数名，却未迁移依赖它的应用行为。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 13 ← 12 移除此参数
该版起不再存在
-
PostgreSQL 9.0 ← 8.4 新增此参数
PostgreSQL 9.0 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 0 |
空 |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.1 | 0 |
空 |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.2 | 0 |
空 |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.3 | 0 |
空 |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.4 | 0 |
空 |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.5 | 0 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 9.6 | 0 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 10 | 0 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 11 | 0 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 12 | 0 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 发送服务器 12 | |||||
idle_replication_slot_timeout |
整数 | 重载生效 | 0 s |
— | |
| 使保持空闲状态（未被复制连接使用）超过此持续时间的复制槽失效。 | 现存 | ||||
max_repack_replication_slots |
整数 | — | — | ||
| 指定可供 REPACK 命令使用的复制槽最大数量。 | 现存 | ||||
max_replication_slots |
整数 | 重启生效 | 10 |
102 次 | |
| 指定服务器可以支持的复制槽（见第 26.2.6 节）最大数量。 | 现存 | ||||
max_slot_wal_keep_size |
整数 | 重载生效 | -1 MB |
— | |
| 指定检查点时复制槽允许在 pg_wal 目录中保留的 WAL 文件最大总量。 | 现存 | ||||
max_wal_senders |
整数 | 重启生效 | 10 |
103 次 | |
| 指定来自备库或流式基础备份客户端的最大并发连接数（即同时运行的 WAL 发送进程的最大数量）。 | 现存 | ||||
output_plugin_libraries |
字符串 | 会话（超级用户） | pgoutput, test_decoding |
— | |
| 列出安装在 dynamic_library_path 所指定位置中、同时也受信任、可供复制客户端用作逻辑输出插件的库。 | 现存 | ||||
replication_timeout |
整数 | 重载生效 | 1 min |
— | |
| 终止不活动时间超过指定毫秒数的复制连接。 | 于 9.3 移除 | ||||
track_commit_timestamp |
布尔 | 重启生效 | off |
— | |
| 记录事务的提交时间。 | 现存 | ||||
wal_keep_segments |
整数 | 重载生效 | 0 |
— | |
| 指定在 pg_wal 目录中保留的过去日志文件段的最小数量，以便备库可能需要获取它们来进行流复制。 | 于 13 移除 | ||||
wal_keep_size |
整数 | 重载生效 | 0 B |
— | |
| 指定在 pg_wal 目录中保留的旧 WAL 文件的最小总量，以便备库需要时获取这些文件进行流复制。 | 现存 | ||||
wal_sender_shutdown_timeout |
整数 | — | — | ||
| 指定服务器在关闭期间等待所有 WAL 数据复制到接收端的最长时间。 | 现存 | ||||
wal_sender_timeout |
整数 | 会话 | 1 min |
121 次 | |
| 终止非活动时间超过此值的复制连接。 | 现存 | ||||