pgpool_adm
PGPool 管理函数
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pgpool | 4.7.1 | ADMIN | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 5900 | pgpool_adm | 否 | 否 | 否 | 是 | 否 | 否 | - |
| 5910 | pgpool_recovery | 否 | 否 | 否 | 是 | 否 | 否 | - |
| 5920 | pgpool_regclass | 否 | 否 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | pgautofailover pg_failover_slots pg_repack pg_rewrite pg_squeeze pg_dirtyread |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 4.7.1 | 1817161514 | pgpool | - |
| RPM | PGDG | 4.7.1 | 1817161514 | pgpool-II-pg$v-extensions | - |
| DEB | PGDG | 4.7.1 | 1817161514 | postgresql-$v-pgpool2 | - |
安装
您可以直接安装 pgpool 扩展包的预置二进制包，首先确保 PGDG 仓库已经添加并启用：
pig repo add pgdg -u # 添加 PGDG 仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pgpool; # 当前活跃 PG 版本安装
pig ext install -y pgpool -v 18 # PG 18
pig ext install -y pgpool -v 17 # PG 17
pig ext install -y pgpool -v 16 # PG 16
pig ext install -y pgpool -v 15 # PG 15
pig ext install -y pgpool -v 14 # PG 14
dnf install -y pgpool-II-pg18-extensions # PG 18
dnf install -y pgpool-II-pg17-extensions # PG 17
dnf install -y pgpool-II-pg16-extensions # PG 16
dnf install -y pgpool-II-pg15-extensions # PG 15
dnf install -y pgpool-II-pg14-extensions # PG 14
apt install -y postgresql-18-pgpool2 # PG 18
apt install -y postgresql-17-pgpool2 # PG 17
apt install -y postgresql-16-pgpool2 # PG 16
apt install -y postgresql-15-pgpool2 # PG 15
apt install -y postgresql-14-pgpool2 # PG 14
创建扩展：
CREATE EXTENSION pgpool_adm;
用法
pgpool_adm 扩展为 Pgpool-II PCP（Pgpool 控制协议）命令提供可从 SQL 调用的包装函数，允许在 PostgreSQL 内管理 Pgpool-II。
可用函数
| 函数 | 描述 |
|---|---|
pgpool_adm_pcp_node_info | 显示给定后端节点的信息 |
pgpool_adm_pcp_health_check_stats | 显示节点的健康检查统计 |
pgpool_adm_pcp_pool_status | 从 pgpool.conf 获取参数 |
pgpool_adm_pcp_node_count | 获取后端节点数量 |
pgpool_adm_pcp_attach_node | 附加后端节点 |
pgpool_adm_pcp_detach_node | 分离后端节点 |
pgpool_adm_pcp_proc_info | 显示 Pgpool-II 子进程信息 |
调用方式
函数支持两种调用约定：
直接参数（主机名、端口、用户名、密码，加上函数特定参数）：
SELECT * FROM pgpool_adm_pcp_node_info('localhost', 9898, 'admin', 'password', 0);
SELECT * FROM pgpool_adm_pcp_node_count('localhost', 9898, 'admin', 'password');
SELECT * FROM pgpool_adm_pcp_pool_status('localhost', 9898, 'admin', 'password');
外部服务器引用（使用端口 9898 和 ~/.pcppass 中的凭据）：
SELECT * FROM pgpool_adm_pcp_node_info(server_name := 'pgpool_server', node_id := 0);
SELECT * FROM pgpool_adm_pcp_node_count(server_name := 'pgpool_server');
节点管理
-- 分离后端节点
SELECT pgpool_adm_pcp_detach_node('localhost', 9898, 'admin', 'password', 1);
-- 重新附加后端节点
SELECT pgpool_adm_pcp_attach_node('localhost', 9898, 'admin', 'password', 1);
默认 PCP 通信端口为 9898。凭据可通过用户主目录中的 .pcppass 文件管理。