软件包

扩展包别名与类别命名规则

Pigsty 使用包别名机制简化扩展的安装与管理。


包别名机制

管理扩展涉及多个层面的名称映射:

层面示例 pgvector示例 postgis
扩展名vectorpostgis, postgis_topology, …
包别名pgvectorpostgis
RPM 包名pgvector_18postgis36_18*
DEB 包名postgresql-18-pgvectorpostgresql-18-postgis-3*

Pigsty 提供包别名抽象层,让用户无需关心具体的 RPM/DEB 包名:

pg_extensions: [ pgvector, postgis, timescaledb ]  # 使用包别名

Pigsty 会根据操作系统和 PostgreSQL 版本自动翻译为正确的包名。

注意:CREATE EXTENSION 时使用的是扩展名(如 vector),而非包别名(pgvector)。


类别别名

所有扩展被划分为 16 个类别,可使用类别别名批量安装:

# 使用通用类别别名(自动适配当前 PG 版本)
pg_extensions: [ pgsql-gis, pgsql-rag, pgsql-fts ]

# 或使用版本特定的类别别名
pg_extensions: [ pg18-gis, pg18-rag, pg18-fts ]

olap 类别外,所有类别的扩展都可以同时安装。olap 类别中存在互斥:pg_duckdbpg_mooncake 冲突。


类别列表

类别说明典型扩展
time时序类timescaledb, pg_cron, periods
gis地理类postgis, h3, pgrouting
rag向量类pgvector, pgml, vchord
fts搜索类pg_trgm, zhparser, pgroonga
olap分析类citus, pg_duckdb, pg_analytics
feat特性类age, pg_graphql, rum
lang语言类plpython3u, pljava, plv8
type类型类hstore, ltree, citext
util工具类http, pg_net, pgjwt
func函数类pgcrypto, uuid-ossp, pg_uuidv7
admin管理类pg_repack, pgagent, pg_squeeze
stat统计类pg_stat_statements, pg_qualstats, auto_explain
sec安全类pgaudit, pgcrypto, pgsodium
fdw外部类postgres_fdw, mysql_fdw, oracle_fdw
sim兼容类orafce, babelfishpg_tds
etl数据类pglogical, wal2json, decoderbufs

查阅扩展目录

您可以在 Pigsty 扩展目录 网站上查阅所有可用扩展的详细信息,包括:

  • 扩展名称、描述、版本
  • 支持的 PostgreSQL 版本
  • 支持的操作系统发行版
  • 安装方式、预加载需求
  • 许可证、来源仓库

最后修改 2025-12-20: new post on pgsql/arch (19aad69)