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 19)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 18)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 17)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 16)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
primary_conninfo (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 复制 / 备用服务器 |
| 简短描述 | 设置用于连接发送服务器的连接字符串。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档: primary_conninfo
变更历史
- PostgreSQL 13
- 现在可以通过配置重载来更改
primary_conninfo(提交 1e614803)
- 现在可以通过配置重载来更改
- PostgreSQL 12
- PostgreSQL 9.0
- 添加(提交 40f908bd)
参考资料
- PostgreSQL 文档: primary_conninfo
- PostgreSQL 11 文档: primary_conninfo
