wal_keep_segments

wal_keep_segments：设置为备库保留的 WAL 文件数量。实测在档范围为 PG9.0–12；最后在档的 PG12 启动默认值为 0，context 为 sighup。它在 PG13 被移除。

说明

Fact — 官方简述译文：设置为备库保留的 WAL 文件数量。

身份

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

设置为备库保留的 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+。

提示

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

场景	建议
OLTP	不要在 PG13+ 调优或继续下发 wal_keep_segments。PostgreSQL 13 用 wal_keep_size 取代按段计数的接口；新参数用字节表示保留下限，不再隐含 WAL 段大小。升级前扫描所有配置层并做业务回归。
OLAP	迁移方案与 OLTP 相同；另外在长批处理、备库或大对象/扩展工作流中验证新机制，不要假定删除旧开关会保留旧行为。
小规格	直接删除旧配置并采用受支持替代项；若没有真实兼容需求，不要用脚本伪造旧行为。

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

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

注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG9.0–12 未修改；OLAP: PG9.0–12 未修改；CRIT: PG9.0–12 未修改；TINY: PG9.0–12 未修改。未发现覆盖值，因此不推断 Pigsty 专属理由。