CONFIGURATION PARAMETER复制 / 发送服务器
wal_keep_segments
设置为备库保留的 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 无变化。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 10 完全一致，下面就是同一段文字。
指定在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.2 ← 9.1 仅描述更新
分类
Replication / Master ServerReplication / Sending Servers -
PostgreSQL 9.1 ← 9.0 仅描述更新
分类
Write-Ahead Log / Streaming ReplicationReplication / Master Server
逐版本快照
每个收录版本里的 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 |
整数 | 重启生效 | 5 |
— | |
| 设置 REPACK 命令可使用的最大复制槽数量。 | 现存 | ||||
max_replication_slots |
整数 | 重启生效 | 10 |
102 次 | |
| 设置可同时定义的复制槽最大数量。 | 现存 | ||||
max_slot_wal_keep_size |
整数 | 重载生效 | -1 MB |
— | |
| 设置复制槽可保留的 WAL 最大大小。 | 现存 | ||||
max_wal_senders |
整数 | 重启生效 | 10 |
103 次 | |
| 设置可同时运行的 WAL sender 进程最大数量。 | 现存 | ||||
output_plugin_libraries |
字符串 | 会话（超级用户） | pgoutput, test_decoding |
— | |
| 列出可作为逻辑解码输出插件指定的库。 | 现存 | ||||
replication_timeout |
整数 | 重载生效 | 1 min |
— | |
| 设置等待 WAL 复制活动的最长时间。 | 于 9.3 移除 | ||||
track_commit_timestamp |
布尔 | 重启生效 | off |
— | |
| 记录事务提交时间。 | 现存 | ||||
wal_keep_segments |
整数 | 重载生效 | 0 |
— | |
| 设置为备库保留的 WAL 文件数量。 | 于 13 移除 | ||||
wal_keep_size |
整数 | 重载生效 | 0 B |
— | |
| 设置为备库保留的 WAL 文件大小。 | 现存 | ||||
wal_sender_shutdown_timeout |
整数 | 会话 | -1 ms |
— | |
| 设置关机时等待 WAL 全部复制到接收端的最长时间。 | 现存 | ||||
wal_sender_timeout |
整数 | 会话 | 1 min |
121 次 | |
| 设置等待 WAL 复制活动的最长时间。 | 现存 | ||||