pgpool_regclass

PGPool辅助扩展，RegClass替代
仓库
https://pgpool.net/
https://pgpool.net/

概览

扩展包名版本分类许可证语言
pgpool4.7.2ADMINPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
5900pgpool_adm否否否是否否-
5910pgpool_recovery否否否是否否-
5920pgpool_regclass否否否是否否-
相关扩展pgbouncer_fdw pgdd meta pg_readme ddlx pg_catcheck

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG4.7.21817161514pgpool-
RPMPGDG4.7.21817161514pgpool-II-pg$v-extensions-
DEBPGDG4.7.21817161514postgresql-$v-pgpool2-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
el8.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
el9.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
el9.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
el10.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
el10.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
d12.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
d12.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
d13.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
d13.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u22.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u22.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u24.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u24.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u26.x86_64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2
u26.aarch64PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2PGDG 4.7.2

安装

您可以直接安装 pgpool 扩展包的预置二进制包，首先确保 PGDG 仓库已经添加并启用：

BASH 
pig repo add pgdg -u          # 添加 PGDG 仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

安装
BASH 
pig install pgpool;          # 当前活跃 PG 版本安装
pig
BASH 
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
BASH 
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
BASH 
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

创建扩展：

SQL 
CREATE EXTENSION pgpool_regclass;

用法

pgpool_regclass: regclass 的替代实现

pgpool_regclass 扩展提供一个替代的 regclass 函数，由 Pgpool-II 内部使用，用于处理跨多个后端的关系名称解析。

函数

SQL 
-- 将关系名称解析为其 OID，类似于 PostgreSQL 的 regclass 强制转换
SELECT pgpool_regclass('my_table');
SELECT pgpool_regclass('my_schema.my_table');

用途

在标准 PostgreSQL 中，将字符串转换为 regclass（例如 'my_table'::regclass）会将关系名称解析为 OID。然而，Pgpool-II 需要判断 SQL 语句引用的是临时表还是普通表，以正确路由查询。

pgpool_regclass 函数以普通函数调用（而非类型转换）的形式提供此解析能力，使 Pgpool-II 能够：

  • 判断引用的表是否存在于后端
  • 区分临时表和永久表以实现正确的查询路由
  • 在连接池中正确处理带模式限定的表名

注意事项

  • 此扩展主要由 Pgpool-II 内部使用，通常不由应用程序直接调用
  • 应安装在 Pgpool-II 管理的所有 PostgreSQL 后端节点上
  • 对于 Pgpool-II 3.0+，此函数有助于 check_temp_table 功能

最后修改 2026-08-12 · extension update 2026-08-12 (7a2fdbbd)