primary_conninfo
指定备用服务器连接到上游服务器的配置参数
primary_conninfo 是一个配置参数，用于指定流复制备用服务器连接到的上游服务器。
请注意，尽管名称暗示了这一点，但自从级联复制在PostgreSQL 9.2中引入以来，指定的服务器可以是另一个备用服务器。
primary_conninfo 在PostgreSQL 9.0中添加。
默认值
primary_conninfo 的默认值为：''（空字符串）。
用法
当前设置
primary_conninfo 的当前设置（由walreceiver使用）包含在系统视图pg_stat_wal_receiver的conninfo列中（PostgreSQL 9.6及更高版本）。但是请注意，conninfo列还将包含任何libpq默认conninfo参数。
在主服务器上的有效性
可以在主服务器（即未处于恢复状态的服务器）上设置primary_conninfo，但它不会有任何效果。
请注意，在将备用服务器提升为主服务器后，服务器的primary_conninfo不会重置，但只要服务器为主服务器，它就不会被使用。
PostgreSQL 13及更高版本
在PostgreSQL 13及更高版本中，primary_conninfo作为正常的GUC处理，可以在postgresql.conf中设置或通过ALTER SYSTEM修改。更改需要重新加载配置才能生效。
PostgreSQL 12
在PostgreSQL 12中，primary_conninfo作为正常的GUC处理，可以在postgresql.conf中设置或通过ALTER SYSTEM修改。更改需要重新启动PostgreSQL实例才能生效。
PostgreSQL 11及更早版本
在PostgreSQL 11及更早版本中，primary_conninfo在recovery.conf中指定；更改需要重新启动PostgreSQL实例才能生效。
按PostgreSQL版本查看详细信息
primary_conninfo (PostgreSQL 18)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 17)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 16)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | sighup |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
primary_conninfo (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 复制/备用服务器 |
| 简短描述 | 设置用于连接到发送服务器的连接字符串。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | false |
变更历史
- PostgreSQL 13
primary_conninfo现在可以通过重新加载配置来更改（提交1e614803）
- PostgreSQL 12
- PostgreSQL 9.0
- 添加（提交40f908bd）
参考文献
- PostgreSQL文档： primary_conninfo
- PostgreSQL 11文档： primary_conninfo