PolarDB PG

使用阿里云开源的 PolarDB for PostgreSQL 内核提供国产信创资质支持,与类似 Oracle RAC 的使用体验。

概览

Pigsty 允许使用 PolarDB 创建带有 “国产化信创资质” 的 PostgreSQL 集群!

PolarDB for PostgreSQL 当前以 PostgreSQL 17 为基线,Pigsty 中的 polar 模板、默认路径与扩展说明也已经同步到 PG17。任何兼容 PostgreSQL 线缆协议的客户端工具都可以访问 PolarDB 集群。

Pigsty 的 PGSQL 仓库中提供了 PolarDB PG 开源版安装包,但不会在 Pigsty 安装时下载到本地软件仓库。


安装

使用 Pigsty 内置模板:

./configure -c polar
./deploy.yml

变更摘要

从 Pigsty v4.4 开始,PolarDB PG 内核将直接使用 pigsty 构建打包的版本,主要变化如下:

项目旧文档 / 旧默认值当前值
内核基线PostgreSQL 15PostgreSQL 17
默认 PolarDB 路径/u01/polardb_pg/usr/polar-17
支持架构x86_64x86_64, aarch64
可用扩展数旧文档正文写为 61pg_available_extensions 查询结果为 93,过滤 contrib 后为 34
复制用户要求replicator 需要 SUPERUSER保持不变

配置

以下参数需要针对 PolarDB 数据库集群进行特殊配置:

#----------------------------------#
# PGSQL & PolarDB
#----------------------------------#
pg_version: 17
pg_mode: polar
pg_packages: [ polardb, pgsql-common ]
pg_exporter_exclude_database: 'template0,template1,postgres,polardb_admin'
pg_default_roles:
  - { name: dbrole_readonly  ,login: false ,comment: role for global read-only access     }
  - { name: dbrole_offline   ,login: false ,comment: role for restricted read-only access }
  - { name: dbrole_readwrite ,login: false ,roles: [dbrole_readonly] ,comment: role for global read-write access }
  - { name: dbrole_admin     ,login: false ,roles: [pg_monitor, dbrole_readwrite] ,comment: role for object creation }
  - { name: postgres     ,superuser: true  ,comment: system superuser }
  - { name: replicator   ,superuser: true  ,replication: true ,roles: [pg_monitor, dbrole_readonly] ,comment: system replicator } # <- superuser is required for replication
  - { name: dbuser_dba   ,superuser: true  ,roles: [dbrole_admin]  ,pgbouncer: true ,pool_mode: session, pool_connlimit: 16 ,comment: pgsql admin user }
  - { name: dbuser_monitor ,roles: [pg_monitor] ,pgbouncer: true ,parameters: {log_min_duration_statement: 1000 } ,pool_mode: session ,pool_connlimit: 8 ,comment: pgsql monitor user }

默认 polar 内核安装目录已调整为 /usr/polar-17。这里特别注意,PolarDB PG 要求 replicator 复制用户为 SUPERUSER,与原生 PG 不同。


扩展列表

PolarDB PG 内核共有 93 个可用扩展,去除 PG Contrib 自带扩展之后,还有以下额外扩展:

扩展名版本号说明
hll2.18type for storing hyperloglog data
ip4r2.4
log_fdw1.4foreign-data wrapper for Postgres log file access
pase0.0.1ant ai similarity search
pg_bigm1.2text similarity measurement and index searching based on bigrams
pg_cron1.5Job scheduler for PostgreSQL
pg_cron_preload1.0polardb pg extend catalog
pg_hint_plan1.7.0optimizer hints for PostgreSQL
pg_jieba1.1.0a parser for full-text search of Chinese
pg_partman5.2.4Extension to manage partitioned tables by time or ID
pg_profile4.10PostgreSQL load profile repository and report builder
pg_repack1.5.1-1Reorganize tables in PostgreSQL databases with minimal locks
pg_similarity1.0support similarity queries
pg_squeeze1.9A tool to remove unused space from a relation.
pg_stat_kcache2.3.0Kernel statistics gathering
pgaudit17.1provides auditing functionality
pgtap1.3.3Unit testing for PostgreSQL
pldbgapi1.1server-side support for debugging PL/pgSQL functions
polar_advisor1.1polar_advisor
polar_feature_utils1.0PolarDB feature utilization
polar_io_stat1.0polar io stat in multi dimension
polar_monitor1.3monitor functions for PolarDB
polar_monitor_preload1.0examine the polardb information
polar_parameter_manager1.2Extension to select parameters for manger.
polar_proxy_utils1.0Extension to provide operations about proxy.
polar_resource_manager1.0a background process that forcibly frees user session process memory
polar_smgrperf1.0smgr perf test extension
polar_tde_utils1.0Internal extension for TDE
polar_vfs1.0polar virtual file system for different storage
polar_worker1.1polar_worker
prefix1.2.0Prefix Range module for PostgreSQL
roaringbitmap0.5support for Roaring Bitmaps
sequential_uuids1.0.3generator of sequential UUIDs
varbitx1.1varbit functions pack

最后修改 2026-07-09: update kernel docs (fbb03fa)