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