此条目涉及 PostgreSQL 中已弃用的功能，该功能在将来的版本中可能会停止支持。
promote_trigger_file 是一个 配置参数，用于指定一个文件路径，如果存在该文件，则会导致备库被提升为主库。
promote_trigger_file 在 PostgreSQL 12 中添加，替代了 recovery.conf 参数 trigger_file，并在 PostgreSQL 16 中移除。
默认值
promote_trigger_file 的默认值为：''（空字符串）。
用法
如果设置了 promote_trigger_file，并在指定位置放置了匹配的文件，则备库将自行提升为主库。
该文件可以为空。它必须可被运行 PostgreSQL 的系统用户读取，否则 PostgreSQL 实例将拒绝启动，或在运行时终止。
在主库上，即使指定位置不可访问，promote_trigger_file 也会被忽略。文件的存在不会有任何影响。
在 PostgreSQL 9.0 中，当引入流复制时，promote_trigger_file 是将正在运行的备库提升为主库的唯一方法。通常，pg_ctl promote（从 PostgreSQL 9.1 开始可用）和 pg_promote() 函数（从 PostgreSQL 12 开始可用）提供了更方便的方法来实现此目的。
按 PostgreSQL 版本分列的详细信息
promote_trigger_file (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 复制/备库服务器 |
| 简短描述 | 指定一个文件名，其存在将结束备库中的恢复。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
promote_trigger_file (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 复制/备库服务器 |
| 简短描述 | 指定一个文件名，其存在将结束备库中的恢复。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
promote_trigger_file (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 复制/备库服务器 |
| 简短描述 | 指定一个文件名，其存在将结束备库中的恢复。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
promote_trigger_file (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 复制/备库服务器 |
| 简短描述 | 指定一个文件名，其存在将结束备库中的恢复。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
变更历史
- PostgreSQL 16
- (提交 cd4329d9)
- PostgreSQL 12
- 添加 (提交 2dedf4d9)
示例
如果 promote_trigger_file 设置为 "/tmp/standby.trg" 并且找到相应的文件，则 PostgreSQL 日志将包含类似以下内容的条目
[2022-11-27 09:47:41 UTC] LOG: 00000: promote trigger file found: /tmp/standby.trg [2022-11-27 09:47:41 UTC] FATAL: 57P01: terminating walreceiver process due to administrator command [2022-11-27 09:47:41 UTC] LOG: 00000: invalid record length at 0/3000208: wanted 24, got 0 [2022-11-27 09:47:41 UTC] LOG: 00000: redo done at 0/30001D0 system usage: CPU: user: 0.00 s, system: 0.00 s, elapsed: 83.20 s [2022-11-27 09:47:41 UTC] LOG: 00000: selected new timeline ID: 2 [2022-11-27 09:47:41 UTC] LOG: 00000: archive recovery complete [2022-11-27 09:47:41 UTC] LOG: 00000: checkpoint starting: force [2022-11-27 09:47:41 UTC] LOG: 00000: database system is ready to accept connections
尝试将 promote_trigger_file 设置为 PostgreSQL 无法访问的位置
[2022-11-27 09:51:18 UTC] LOG: 00000: received SIGHUP, reloading configuration files [2022-11-27 09:51:18 UTC] LOG: 00000: parameter "promote_trigger_file" changed to "/root/standby.trg" [2022-11-27 09:51:18 UTC] FATAL: 42501: could not stat promote trigger file "/root/standby.trg": Permission denied [2022-11-27 09:51:18 UTC] LOG: 00000: startup process (PID 2210329) exited with exit code 1 [2022-11-27 09:51:18 UTC] LOG: 00000: terminating any other active server processes [2022-11-27 09:51:18 UTC] LOG: 00000: shutting down due to startup process failure [2022-11-27 09:51:18 UTC] LOG: 00000: database system is shut down
参考文献
- PostgreSQL 文档： promote_trigger_file