promote_trigger_file

promote_trigger_file：指定一个文件，其出现会使备库结束恢复。它存在于 PG12–15 实测矩阵，并在 PG16 移除。PostgreSQL 16 移除了触发文件机制；应由 HA 控制器调用 pg_ctl promote 或 pg_promote()。

说明

Fact — 官方简述译文：指定一个文件，其出现会使备库结束恢复。

身份

Fact	值
首次观测	PG12
在档版本	PG12–15
移除版本	PG16
引入提交	`2dedf4d9a899` — Integrate recovery.conf into postgresql.conf
提交日期	2018-11-25
Discussion	讨论 1

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

指定一个文件，其出现会使备库结束恢复。该参数在 PG15 仍存在，并从 PG16 起不再被识别。PostgreSQL 16 移除了触发文件机制；应由 HA 控制器调用 pg_ctl promote 或 pg_promote()。

该机制存在时，恢复进程监视指定路径并在文件出现后提升。残留文件、竞态与共享存储语义使编排脆弱；PostgreSQL 16 移除了这一设置。

升级前应联合检查 hot_standby、hot_standby_feedback、max_standby_archive_delay，从配置、ALTER SYSTEM、角色/数据库设置和自动化模板中删除旧名，并先验证替代机制再启动 PG16+。

提示

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

场景	建议
OLTP	不要在 PG16+ 调优或继续下发 promote_trigger_file。PostgreSQL 16 移除了触发文件机制；应由 HA 控制器调用 pg_ctl promote 或 pg_promote()。升级前扫描所有配置层并做业务回归。
OLAP	迁移方案与 OLTP 相同；另外在长批处理、备库或大对象/扩展工作流中验证新机制，不要假定删除旧开关会保留旧行为。
小规格	直接删除旧配置并采用受支持替代项；若没有真实兼容需求，不要用脚本伪造旧行为。

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

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

注意

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