跳到主要内容
支持地域：上海

支持的扩展

本文列出 CloudBase PostgreSQL 当前提供的扩展。扩展支持范围、版本和权限要求可能随实例版本变化，请以实际数据库查询结果和控制台展示为准。

扩展总览​

扩展版本功能
address_standardizer3.5.0地址解析和标准化，常用于地理编码前的数据清洗。
address_standardizer_data_us3.5.0美国地址标准化示例数据集。
age1.5.0Apache AGE 图数据库能力，可在 PostgreSQL 中处理图数据。
amcheck1.4检查索引和关系完整性，适合低层数据一致性诊断。
autoinc1.0通过触发器自动维护自增字段。
bloom1.0Bloom 索引访问方法，适合多列等值过滤的签名索引。
bool_plperl1.0在 bool 与 PL/Perl 之间做类型转换。
btree_gin1.3为常见 B-tree 数据类型提供 GIN 索引支持。
btree_gist1.7为常见 B-tree 数据类型提供 GiST 索引支持。
chkpass1.0自动加密密码的数据类型。
citext1.6大小写不敏感的文本类型。
cos_fdw1.0访问腾讯云 COS 平面文件的外部数据封装器。
count_distinct3.0.2COUNT(DISTINCT ...) 的替代聚合实现，可配合 HashAggregate 使用。
cube1.5多维立方体数据类型。
dblink1.2从当前数据库连接并查询其他 PostgreSQL 数据库。
decoderbufs0.1.0使用 Protocol Buffer 格式输出 WAL 变更的逻辑解码插件。
dict_int1.0整数全文检索字典模板。
dict_xsyn1.0扩展同义词全文检索字典模板。
earthdistance1.2计算地球表面大圆距离。
fuzzystrmatch1.2字符串相似度和距离计算。
hll2.18HyperLogLog 数据类型，适合近似去重统计。
hstore1.8键值对集合数据类型。
hstore_plperl1.0在 hstore 与 PL/Perl 之间做类型转换。
hypopg1.4.1创建假设索引，用于评估索引效果而不真正建索引。
imgsmlr1.0图片相似度模块。
insert_username1.0跟踪表数据变更用户。
intagg1.1整数聚合与枚举扩展，已过时。
intarray1.5一维整数数组的函数、操作符和索引支持。
isn1.2国际产品编号标准相关数据类型。
jsonb_plperl1.0在 jsonb 与 PL/Perl 之间做类型转换。
lo1.1Large Object 维护能力。
ltree1.3层级树状结构路径数据类型。
moddatetime1.0自动维护最后修改时间。
mysql_fdw1.2查询 MySQL 服务的外部数据封装器。
pageinspect1.12低层检查数据库页面内容。
pg_bigm1.2基于 bigram 的文本相似度和索引搜索。
pg_buffercache1.5查看共享缓冲区缓存内容。
pg_cron1.6PostgreSQL 内部任务调度器。
pg_freespacemap1.2检查空闲空间映射。
pg_hashids1.3Hashids 编码能力。
pg_hint_plan1.7.0为查询优化器提供 hint。
pg_ivm1.11增量维护物化视图。
pg_jieba1.1.1中文全文检索分词解析器。
pg_partman4.7.4按时间或 ID 管理分区表。
pg_prewarm1.2预热关系数据到缓存。
pg_repack1.5.2以较低锁影响重整表和索引。
pg_similarity1.0相似度查询支持。
pg_sphere1.5.1球面对象、函数、操作符和索引支持。
pg_squeeze1.9移除关系中的未使用空间。
pg_stat_log1.0跟踪 SQL 运行时执行统计。
pg_stat_statements1.11跟踪 SQL 计划与执行统计。
pg_surgery1.0对损坏关系执行低层修复操作。
pg_trgm1.6基于 trigram 的文本相似度和索引搜索。
pg_visibility1.2检查可见性映射和页级可见性信息。
pg_walinspect1.1检查 WAL 内容。
pgagent4.2PostgreSQL 任务调度器。
pgaudit17.0审计日志能力。
pgcrypto1.3加密、摘要和随机值函数。
pglogical2.4.5PostgreSQL 逻辑复制。
pglogical_origin1.0.0PostgreSQL 9.4 升级兼容占位扩展。
pgrouting3.6.2pgRouting 路由计算扩展。
pgrowlocks1.2显示行级锁信息。
pgstattuple1.5显示 tuple 级统计信息。
pldbgapi1.1PL/pgSQL 服务端调试支持。
plperl1.0PL/Perl 过程语言。
plpgsql1.0PL/pgSQL 过程语言。
pltcl1.0PL/Tcl 过程语言。
plv83.2.3受信任 PL/JavaScript(v8) 过程语言。
postgis3.5.0PostGIS 几何和地理空间类型与函数。
postgis_raster3.5.0PostGIS 栅格类型和函数。
postgis_sfcgal3.5.0PostGIS SFCGAL 函数。
postgis_tiger_geocoder3.5.0PostGIS tiger 地理编码和反向地理编码。
postgis_topology3.5.0PostGIS 拓扑空间类型和函数。
postgres_fdw1.1查询远程 PostgreSQL 服务的外部数据封装器。
rdkit4.7.0化学信息学能力。
rds_server_handler1.0TencentDB PostgreSQL 服务处理扩展。
refint1.0实现引用完整性的函数，已过时。
roaringbitmap0.5Roaring Bitmap 支持。
rum1.3RUM 索引访问方法。
seg1.4线段或浮点区间数据类型。
sequential_uuids1.0.2生成顺序 UUID。
smlar1.0一维数组相似度计算。
sslinfo1.2SSL 证书信息。
starrocks_fdw1.2查询 StarRocks 服务的外部数据封装器。
tablefunc1.0整表操作函数，包括 crosstab。
tcn1.0触发式变更通知。
tencentdb_ai1.3腾讯云数据库 AI 扩展，可集成 prompt、embedding 等 AI 能力。
tencentdb_failover_slot1.1故障切换 slot 相关函数。
tencentdb_index_advisor1.0TencentDB PostgreSQL 查询和工作负载级索引顾问。
tencentdb_serverless1.0serverless 模式支持扩展。
tencentdb_sql_throttling1.0跟踪 SQL 计划与执行统计。
tencentdb_superuser1.1升级支持扩展。
tencentdb_system_stat1.0跟踪 SQL 执行统计。
tencentdb_wal_stat1.0按关系聚合 WAL 统计。
timescaledb2.23.0时序数据扩展，支持高吞吐写入和复杂查询。
topn2.6.0Top-N JSONB 类型。
tsm_system_rows1.0按行数限制的 TABLESAMPLE 方法。
tsm_system_time1.0按时间限制的 TABLESAMPLE 方法。
unaccent1.1移除重音字符的全文检索字典。
uuid-ossp1.1生成 UUID。
vector0.8.2向量数据类型和 ivfflat、hnsw 索引方法。
vectorscale0.9.0用于向量搜索的 diskann 访问方法。
xml21.1XPath 查询和 XSLT 支持。
zhparser2.2中文全文检索解析器。

使用建议​

  • 本文采用扩展总览加单项说明的方式组织，便于按功能查找扩展。CloudBase PostgreSQL 的扩展支持范围以当前实例查询结果为准。
  • 使用扩展前，建议先在测试环境验证权限、性能、备份恢复和跨环境迁移影响。
  • FDW、调度、审计、复制、过程语言、低层诊断等扩展通常需要更严格的权限治理。
  • 扩展提供的是数据库能力，不建议把低层诊断、复制、调度或外部数据访问能力直接暴露给前端。

扩展介绍​

address_standardizer​

  • 名称：address_standardizer
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：地址解析和标准化，常用于地理编码前的数据清洗。
  • 使用说明：在导入用户地址、门店地址或物流地址后，可先用该扩展把自由文本地址拆解为街道、城市、邮编等结构化字段，再进入地理编码或地址匹配流程。
  • 注意事项：地址解析依赖规则和数据集，建议对目标国家或地区做样本校验；不要把解析结果直接作为唯一地址校验依据。

address_standardizer_data_us​

  • 名称：address_standardizer_data_us
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：美国地址标准化示例数据集。
  • 使用说明：配合 address_standardizer 处理美国地址样例或美国地址标准化验证，适合演示、测试和美国地址数据清洗。
  • 注意事项：该数据集面向美国地址，不适合作为中国或其他地区地址标准化规则；跨地区业务应准备本地化规则和测试集。

age​

  • 名称：age
  • 版本：1.5.0
  • 访问链接：Apache AGE 官网
  • 功能：Apache AGE 图数据库能力，可在 PostgreSQL 中处理图数据。
  • 使用说明：用于在 PostgreSQL 中建模图结构，例如用户关系、知识图谱、依赖关系和路径查询。适合需要图遍历和关系推理的场景。
  • 注意事项：图查询模型与传统关系模型不同，引入前应确认查询语言、索引方式和备份恢复流程；复杂图遍历可能带来较高计算成本。

amcheck​

  • 名称：amcheck
  • 版本：1.4
  • 访问链接：PostgreSQL 文档
  • 功能：检查索引和关系完整性，适合低层数据一致性诊断。
  • 使用说明：在怀疑索引损坏、关系页异常或需要做低层一致性巡检时使用，通过校验函数检查 B-tree 等结构。
  • 注意事项：该扩展偏底层诊断，通常由 DBA 或运维人员使用；校验大对象可能消耗 IO，建议在低峰期执行。

autoinc​

  • 名称：autoinc
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：通过触发器自动维护自增字段。
  • 使用说明：用于旧表或兼容场景中通过触发器为字段生成递增值。新表优先使用 identity、serial 或序列。
  • 注意事项：触发器自增容易隐藏写入逻辑，新项目不建议优先使用；并发写入场景应确认唯一性和事务行为。

bloom​

  • 名称：bloom
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：Bloom 索引访问方法，适合多列等值过滤的签名索引。
  • 使用说明：当查询经常按多个列组合做等值过滤，且不适合建立大量组合 B-tree 索引时，可考虑 Bloom 索引。
  • 注意事项：Bloom 索引存在误判，需要回表复查；它不适合范围查询，也不一定替代精确 B-tree 组合索引。

bool_plperl​

  • 名称：bool_plperl
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：在 bool 与 PL/Perl 之间做类型转换。
  • 使用说明：在 PL/Perl 函数需要处理 PostgreSQL boolean 类型时使用，让过程语言函数能正确读写 bool 值。
  • 注意事项：过程语言扩展会扩大数据库内可执行逻辑范围，应限制函数创建权限并避免在前端可调用函数中执行不受控逻辑。

btree_gin​

  • 名称：btree_gin
  • 版本：1.3
  • 访问链接：PostgreSQL 文档
  • 功能：为常见 B-tree 数据类型提供 GIN 索引支持。
  • 使用说明：在一个 GIN 索引中组合普通标量字段与数组、全文检索或 JSONB 字段时使用，减少多索引组合成本。
  • 注意事项：GIN 索引写入成本较高；如果只是普通等值或范围查询，优先使用 B-tree。

btree_gist​

  • 名称：btree_gist
  • 版本：1.7
  • 访问链接：PostgreSQL 文档
  • 功能：为常见 B-tree 数据类型提供 GiST 索引支持。
  • 使用说明：在 GiST 索引或排他约束中使用普通标量类型，例如时间区间冲突检测、范围约束和空间数据组合约束。
  • 注意事项：GiST 索引适合特定操作符族；普通排序和等值查询仍优先考虑 B-tree。

chkpass​

  • 名称：chkpass
  • 版本：1.0
  • 访问链接：PostgreSQL 历史文档
  • 功能：自动加密密码的数据类型。
  • 使用说明：用于兼容旧系统中数据库内密码字段的自动加密存储。新应用通常应使用专门的认证服务和成熟密码哈希方案。
  • 注意事项：该扩展已不适合作为现代认证体系的首选；不要自行设计登录密码存储方案。

citext​

  • 名称：citext
  • 版本：1.6
  • 访问链接：PostgreSQL 文档
  • 功能：大小写不敏感的文本类型。
  • 使用说明：用于邮箱、用户名、标签等大小写不敏感字段，避免每次查询都写 lower(column) 比较。
  • 注意事项：使用 citext 前要确认唯一性语义，例如邮箱是否需要大小写不敏感唯一约束；排序和本地化规则仍需测试。

cos_fdw​

  • 名称：cos_fdw
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：访问腾讯云 COS 平面文件的外部数据封装器。
  • 使用说明：用于把 COS 中的结构化文件映射为外部表，适合低频数据导入、分析或临时查询。
  • 注意事项：FDW 查询受外部存储、网络和文件格式影响，不建议承载高频在线交易查询；注意 COS 访问凭据管理。

count_distinct​

  • 名称：count_distinct
  • 版本：3.0.2
  • 访问链接：PGXN
  • 功能：COUNT(DISTINCT ...) 的替代聚合实现，可配合 HashAggregate 使用。
  • 使用说明：在大规模聚合去重统计中用于优化 count distinct 的执行方式，适合分析类查询。
  • 注意事项：效果依赖数据分布和执行计划，上线前应对比 EXPLAIN ANALYZE；不要盲目替换所有 COUNT(DISTINCT)。

cube​

  • 名称：cube
  • 版本：1.5
  • 访问链接：PostgreSQL 文档
  • 功能：多维立方体数据类型。
  • 使用说明：用于多维点、范围和相似度计算，常与 GiST 索引配合处理简单向量或多维数据。
  • 注意事项：复杂向量检索优先考虑 vector/vectorscale；cube 更适合较低维的几何或多维数值场景。
  • 名称：dblink
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：从当前数据库连接并查询其他 PostgreSQL 数据库。
  • 使用说明：用于跨 PostgreSQL 数据库执行查询或迁移少量数据，可在函数或 SQL 中拉取远端结果。
  • 注意事项：连接信息和凭据需要严格保护；跨库查询不适合高频业务路径，网络波动会直接影响查询稳定性。

decoderbufs​

  • 名称：decoderbufs
  • 版本：0.1.0
  • 访问链接：GitHub
  • 功能：使用 Protocol Buffer 格式输出 WAL 变更的逻辑解码插件。
  • 使用说明：用于逻辑复制或变更数据捕获，将 WAL 变化编码为 Protocol Buffer 供下游消费。
  • 注意事项：需要理解复制槽、WAL 保留和消费延迟；下游长期不消费可能导致 WAL 积压。

dict_int​

  • 名称：dict_int
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：整数全文检索字典模板。
  • 使用说明：用于全文检索配置中处理整数 token，例如商品编号、版本号、分类编码等数字词项。
  • 注意事项：全文检索字典需要和 text search configuration 配套配置；修改分词策略后应重建或刷新相关索引。

dict_xsyn​

  • 名称：dict_xsyn
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：扩展同义词全文检索字典模板。
  • 使用说明：用于全文检索中的同义词扩展，例如品牌别名、业务术语别名或多写法匹配。
  • 注意事项：同义词字典会影响召回范围，应通过样本查询验证误召回；词库维护需要纳入发布流程。

earthdistance​

  • 名称：earthdistance
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：计算地球表面大圆距离。
  • 使用说明：用于经纬度点之间的距离计算、附近门店筛选和粗粒度地理范围查询，常与 cube 配合使用。
  • 注意事项：地球距离计算依赖坐标合法性；复杂 GIS 查询、投影和空间索引建议使用 PostGIS。

fuzzystrmatch​

  • 名称：fuzzystrmatch
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：字符串相似度和距离计算。
  • 使用说明：用于拼写纠错、模糊匹配、音近匹配或数据清洗中的近似字符串比较。
  • 注意事项：相似度计算可能较耗 CPU；在线查询应限制候选集，避免对大表全量逐行计算。

hll​

  • 名称：hll
  • 版本：2.18
  • 访问链接：GitHub
  • 功能：HyperLogLog 数据类型，适合近似去重统计。
  • 使用说明：用于 UV、独立用户数、去重设备数等大规模近似统计，降低精确 distinct 的成本。
  • 注意事项：HLL 是近似结果，不适合财务、库存、结算等需要精确计数的场景。

hstore​

  • 名称：hstore
  • 版本：1.8
  • 访问链接：PostgreSQL 文档
  • 功能：键值对集合数据类型。
  • 使用说明：用于存储简单 key-value 属性，例如稀疏配置、标签属性和兼容旧系统数据。
  • 注意事项：新项目通常优先考虑 jsonb；如果需要复杂嵌套结构，hstore 不如 jsonb 灵活。

hstore_plperl​

  • 名称：hstore_plperl
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：在 hstore 与 PL/Perl 之间做类型转换。
  • 使用说明：在 PL/Perl 函数中处理 hstore 字段时使用，让函数能读取和返回 hstore 数据。
  • 注意事项：结合过程语言使用时，应限制函数创建和执行权限，避免把复杂业务脚本放入数据库。

hypopg​

  • 名称：hypopg
  • 版本：1.4.1
  • 访问链接：GitHub
  • 功能：创建假设索引，用于评估索引效果而不真正建索引。
  • 使用说明：用于索引设计阶段评估某个索引是否可能改善查询计划，适合查询优化和索引评审。
  • 注意事项：假设索引不会真实加速查询，只影响规划评估；最终仍需创建真实索引并压测验证。

imgsmlr​

  • 名称：imgsmlr
  • 版本：1.0
  • 访问链接：GitHub
  • 功能：图片相似度模块。
  • 使用说明：用于在数据库内进行图片相似度比较或相似图片检索的实验性/专用场景。
  • 注意事项：图片特征存储和相似度计算可能占用较多资源；大规模图片检索通常建议使用专门向量检索方案。

insert_username​

  • 名称：insert_username
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：跟踪表数据变更用户。
  • 使用说明：用于通过触发器记录插入或修改数据的数据库用户名，适合审计字段自动填充。
  • 注意事项：记录的是数据库会话用户，不一定等同于业务用户；前端用户身份应结合 auth.uid() 或业务 user_id。

intagg​

  • 名称：intagg
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：整数聚合与枚举扩展，已过时。
  • 使用说明：用于兼容旧 SQL 中的整数聚合函数。新查询优先使用 PostgreSQL 内置聚合和数组函数。
  • 注意事项：该扩展已过时，不建议在新业务中引入。

intarray​

  • 名称：intarray
  • 版本：1.5
  • 访问链接：PostgreSQL 文档
  • 功能：一维整数数组的函数、操作符和索引支持。
  • 使用说明：用于整数数组的包含、交集、排序、去重和索引查询，适合标签 ID、分类 ID 等整数集合。
  • 注意事项：数组适合小规模集合；如果集合元素需要独立权限、统计或关联，建议拆成关联表。

isn​

  • 名称：isn
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：国际产品编号标准相关数据类型。
  • 使用说明：用于 ISBN、EAN、UPC、ISMN 等国际编号的格式校验和存储。
  • 注意事项：只适合标准编号字段；导入历史数据前应处理格式不一致和非法编号。

jsonb_plperl​

  • 名称：jsonb_plperl
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：在 jsonb 与 PL/Perl 之间做类型转换。
  • 使用说明：在 PL/Perl 函数中处理 jsonb 字段时使用，适合已有 Perl 数据处理逻辑迁移。
  • 注意事项：过程语言中的 JSON 处理逻辑应保持简单；复杂转换建议放在应用层或批处理任务中。

lo​

  • 名称：lo
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：Large Object 维护能力。
  • 使用说明：用于维护 PostgreSQL Large Object，适合兼容老系统的大对象存储。
  • 注意事项：新业务通常不建议把大文件放入数据库；优先使用云存储，并在数据库中保存文件 URL 或元数据。

ltree​

  • 名称：ltree
  • 版本：1.3
  • 访问链接：PostgreSQL 文档
  • 功能：层级树状结构路径数据类型。
  • 使用说明：用于组织架构、分类树、路径权限、菜单树等层级路径查询。
  • 注意事项：层级路径更新可能影响子树；设计路径格式和索引前应考虑节点移动频率。

moddatetime​

  • 名称：moddatetime
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：自动维护最后修改时间。
  • 使用说明：用于通过触发器自动更新 updated_at 字段，减少应用层重复赋值。
  • 注意事项：触发器会增加写入时的隐式逻辑；需要在数据修复和批量导入时确认是否符合预期。

mysql_fdw​

  • 名称：mysql_fdw
  • 版本：1.2
  • 访问链接：GitHub
  • 功能：查询 MySQL 服务的外部数据封装器。
  • 使用说明：用于从 PostgreSQL 查询 MySQL 表，适合迁移、对账、低频联邦查询或过渡期集成。
  • 注意事项：跨库查询依赖 MySQL 可用性和网络稳定性；高频业务读写建议同步数据或迁移到本地表。

pageinspect​

  • 名称：pageinspect
  • 版本：1.12
  • 访问链接：PostgreSQL 文档
  • 功能：低层检查数据库页面内容。
  • 使用说明：用于检查表、索引页面的底层结构，辅助诊断损坏、膨胀或存储异常。
  • 注意事项：该扩展面向 DBA 诊断，不建议普通业务账号使用；错误解读底层信息可能导致误判。

pg_bigm​

  • 名称：pg_bigm
  • 版本：1.2
  • 访问链接：GitHub
  • 功能：基于 bigram 的文本相似度和索引搜索。
  • 使用说明：用于中文、日文等语言的双字词相似度搜索和模糊匹配。
  • 注意事项：效果依赖语料和查询模式；需要和 pg_trgm、zhparser、pg_jieba 对比后选择。

pg_buffercache​

  • 名称：pg_buffercache
  • 版本：1.5
  • 访问链接：PostgreSQL 文档
  • 功能：查看共享缓冲区缓存内容。
  • 使用说明：用于观察哪些关系页占用了 shared buffer，辅助分析缓存命中和热点表。
  • 注意事项：读取到的缓存内容是瞬时视图，不能替代长期监控；查询结果可能较底层。

pg_cron​

  • 名称：pg_cron
  • 版本：1.6
  • 访问链接：GitHub
  • 功能：PostgreSQL 内部任务调度器。
  • 使用说明：用于在数据库内定时执行 SQL，例如定期汇总、清理过期数据、刷新统计表。
  • 注意事项：定时任务运行在数据库侧，避免执行长任务或外部依赖；任务失败告警和审计需要单独设计。

pg_freespacemap​

  • 名称：pg_freespacemap
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：检查空闲空间映射。
  • 使用说明：用于分析表和索引页中的空闲空间，辅助判断膨胀和维护需求。
  • 注意事项：属于低层诊断工具，通常配合 vacuum、repack 或统计信息使用。

pg_hashids​

  • 名称：pg_hashids
  • 版本：1.3
  • 访问链接：GitHub
  • 功能：Hashids 编码能力。
  • 使用说明：用于把数字 ID 编码为较短、非连续外显 ID，适合 URL 或公开编号展示。
  • 注意事项：Hashids 不是加密，不应作为安全授权依据；内部仍应使用真实主键和权限校验。

pg_hint_plan​

  • 名称：pg_hint_plan
  • 版本：1.7.0
  • 访问链接：项目文档
  • 功能：为查询优化器提供 hint。
  • 使用说明：用于在特殊场景下通过 hint 影响执行计划，辅助处理优化器选择不佳的 SQL。
  • 注意事项：hint 会增加 SQL 与执行计划耦合，应作为最后手段；优先通过索引、统计信息和 SQL 改写优化。

pg_ivm​

  • 名称：pg_ivm
  • 版本：1.11
  • 访问链接：GitHub
  • 功能：增量维护物化视图。
  • 使用说明：用于让物化视图在基础表变更时增量更新，适合预聚合和派生数据维护。
  • 注意事项：增量维护会增加写入成本；基础表高频写入时需评估总体吞吐。

pg_jieba​

  • 名称：pg_jieba
  • 版本：1.1.1
  • 访问链接：GitHub
  • 功能：中文全文检索分词解析器。
  • 使用说明：用于中文文本分词和全文检索，适合文章、工单、商品名称等中文搜索。
  • 注意事项：分词词典和业务术语会影响搜索效果；上线前应使用真实语料测试召回和排序。

pg_partman​

  • 名称：pg_partman
  • 版本：4.7.4
  • 访问链接：GitHub
  • 功能：按时间或 ID 管理分区表。
  • 使用说明：用于自动创建和维护分区，适合日志、订单、事件、时序数据等持续增长大表。
  • 注意事项：分区键选择会影响查询和维护成本；上线前应规划保留策略和归档策略。

pg_prewarm​

  • 名称：pg_prewarm
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：预热关系数据到缓存。
  • 使用说明：用于重启或冷启动后把热点表/索引预加载到缓存，降低首次查询抖动。
  • 注意事项：预热会占用 IO 和缓存空间；只对明确热点对象使用。

pg_repack​

  • 名称：pg_repack
  • 版本：1.5.2
  • 访问链接：项目主页
  • 功能：以较低锁影响重整表和索引。
  • 使用说明：用于清理表或索引膨胀，在线重整物理存储，降低维护窗口压力。
  • 注意事项：操作期间会额外占用磁盘和资源；大表执行前需确认空间、锁和回滚计划。

pg_similarity​

  • 名称：pg_similarity
  • 版本：1.0
  • 访问链接：GitHub
  • 功能：相似度查询支持。
  • 使用说明：用于多种字符串相似度算法的比较和搜索，适合数据清洗、去重和模糊匹配。
  • 注意事项：相似度算法需要结合业务阈值调优；大表直接计算可能很慢。

pg_sphere​

  • 名称：pg_sphere
  • 版本：1.5.1
  • 访问链接：项目主页
  • 功能：球面对象、函数、操作符和索引支持。
  • 使用说明：用于天文、地理球面坐标和球面距离/区域计算。
  • 注意事项：通用地理业务优先评估 PostGIS；球面模型和坐标单位需要严格校验。

pg_squeeze​

  • 名称：pg_squeeze
  • 版本：1.9
  • 访问链接：GitHub
  • 功能：移除关系中的未使用空间。
  • 使用说明：用于在线清理表膨胀、回收空间，适合持续更新/删除后空间浪费明显的表。
  • 注意事项：维护过程会消耗资源并影响写入，应在低峰期执行并监控锁等待。

pg_stat_log​

  • 名称：pg_stat_log
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：跟踪 SQL 运行时执行统计。
  • 使用说明：用于查看 SQL 运行时统计和性能诊断，辅助定位高耗时或高频 SQL。
  • 注意事项：统计视图用于诊断，不应作为业务功能依赖；查询统计信息时注意权限和数据敏感性。

pg_stat_statements​

  • 名称：pg_stat_statements
  • 版本：1.11
  • 访问链接：PostgreSQL 文档
  • 功能：跟踪 SQL 计划与执行统计。
  • 使用说明：用于聚合查看 SQL 调用次数、耗时、行数和计划信息，是定位慢查询和高频 SQL 的常用工具。
  • 注意事项：需要定期结合业务上下文解读；归一化 SQL 可能隐藏具体参数差异。

pg_surgery​

  • 名称：pg_surgery
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：对损坏关系执行低层修复操作。
  • 使用说明：用于极端情况下对损坏关系进行低层修复。
  • 注意事项：高风险诊断修复工具，仅应由熟悉 PostgreSQL 存储结构的人员在备份后使用。

pg_trgm​

  • 名称：pg_trgm
  • 版本：1.6
  • 访问链接：PostgreSQL 文档
  • 功能：基于 trigram 的文本相似度和索引搜索。
  • 使用说明：用于模糊搜索、相似文本排序、LIKE/ILIKE 加速，适合名称、标题、邮箱等短文本。
  • 注意事项：GIN/GiST trigram 索引会增加写入成本；中文搜索可能需要与 pg_bigm、zhparser 或 pg_jieba 对比。

pg_visibility​

  • 名称：pg_visibility
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：检查可见性映射和页级可见性信息。
  • 使用说明：用于分析 visibility map，辅助 vacuum、索引仅扫描和表维护诊断。
  • 注意事项：偏底层维护工具，不适合业务查询路径；结果需要结合 vacuum 和统计信息理解。

pg_walinspect​

  • 名称：pg_walinspect
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：检查 WAL 内容。
  • 使用说明：用于分析 WAL 记录，辅助复制、恢复和写入放大诊断。
  • 注意事项：WAL 检查涉及底层日志信息，通常用于运维排查；注意数据敏感性。

pgagent​

  • 名称：pgagent
  • 版本：4.2
  • 访问链接：GitHub
  • 功能：PostgreSQL 任务调度器。
  • 使用说明：用于管理定时 SQL 任务和作业流程，适合数据库内定期维护或报表任务。
  • 注意事项：调度任务失败、重试和权限需要单独治理；复杂编排建议使用外部任务系统。

pgaudit​

  • 名称：pgaudit
  • 版本：17.0
  • 访问链接：GitHub
  • 功能：审计日志能力。
  • 使用说明：用于记录数据库访问和操作审计，满足合规、追踪和安全分析需求。
  • 注意事项：审计日志可能显著增加日志量；用于合规审计前应设计采集、留存、脱敏和告警策略。

pgcrypto​

  • 名称：pgcrypto
  • 版本：1.3
  • 访问链接：PostgreSQL 文档
  • 功能：加密、摘要和随机值函数。
  • 使用说明：用于生成随机值、哈希摘要、UUID、加密/解密等数据库内安全辅助能力。
  • 注意事项：不要把数据库内加密函数当作完整密钥管理系统；密钥和敏感数据应使用专门的密钥管理策略。

pglogical​

  • 名称：pglogical
  • 版本：2.4.5
  • 访问链接：GitHub
  • 功能：PostgreSQL 逻辑复制。
  • 使用说明：用于表级逻辑复制、跨库同步、迁移或双写过渡场景。
  • 注意事项：复制槽和订阅需要持续监控；复制延迟或中断可能导致 WAL 积压和数据不一致。

pglogical_origin​

  • 名称：pglogical_origin
  • 版本：1.0.0
  • 访问链接：GitHub
  • 功能：PostgreSQL 9.4 升级兼容占位扩展。
  • 使用说明：用于兼容从旧版本 PostgreSQL 升级或迁移时的 pglogical origin 依赖。
  • 注意事项：通常不作为新业务功能直接使用；仅在迁移兼容需要时保留。

pgrouting​

  • 名称：pgrouting
  • 版本：3.6.2
  • 访问链接：pgRouting 文档
  • 功能：pgRouting 路由计算扩展。
  • 使用说明：用于道路网络、路径规划、最短路径和图路由分析，通常结合 PostGIS 数据使用。
  • 注意事项：路由图数据质量直接影响结果；大规模路径计算应评估索引、预处理和计算成本。

pgrowlocks​

  • 名称：pgrowlocks
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：显示行级锁信息。
  • 使用说明：用于排查行锁等待、事务阻塞和并发写入冲突。
  • 注意事项：查询锁信息可能需要较高权限；只作为诊断工具，不应放入业务查询。

pgstattuple​

  • 名称：pgstattuple
  • 版本：1.5
  • 访问链接：PostgreSQL 文档
  • 功能：显示 tuple 级统计信息。
  • 使用说明：用于检查表和索引膨胀、死元组比例和空间浪费。
  • 注意事项：扫描对象可能消耗 IO；大表建议低峰期执行，并结合 autovacuum 和 repack 策略。

pldbgapi​

  • 名称：pldbgapi
  • 版本：1.1
  • 访问链接：GitHub
  • 功能：PL/pgSQL 服务端调试支持。
  • 使用说明：用于调试 PL/pgSQL 函数，辅助开发复杂数据库过程逻辑。
  • 注意事项：调试能力不应开放给普通业务角色；生产环境使用前需评估权限和安全影响。

plperl​

  • 名称：plperl
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：PL/Perl 过程语言。
  • 使用说明：用于在数据库函数中编写 Perl 逻辑，适合迁移已有 Perl 数据处理代码。
  • 注意事项：过程语言会扩大数据库执行面；新项目应优先使用 SQL/PLpgSQL 或应用层逻辑。

plpgsql​

  • 名称：plpgsql
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：PL/pgSQL 过程语言。
  • 使用说明：用于编写 PostgreSQL 函数、触发器和过程逻辑，是数据库函数开发的常用语言。
  • 注意事项：函数逻辑应保持清晰可测试；复杂业务编排仍建议放在服务端应用中。

pltcl​

  • 名称：pltcl
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：PL/Tcl 过程语言。
  • 使用说明：用于在数据库函数中编写 Tcl 逻辑，适合兼容已有 Tcl 脚本。
  • 注意事项：仅建议兼容历史系统使用；需要严格限制函数创建权限。

plv8​

  • 名称：plv8
  • 版本：3.2.3
  • 访问链接：PLV8 文档
  • 功能：受信任 PL/JavaScript(v8) 过程语言。
  • 使用说明：用于在数据库内编写 JavaScript 函数，适合少量数据转换或兼容已有 JS 逻辑。
  • 注意事项：JavaScript 运行在数据库进程内，复杂逻辑可能影响稳定性；不建议承载业务编排。

postgis​

  • 名称：postgis
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：PostGIS 几何和地理空间类型与函数。
  • 使用说明：用于地理围栏、附近搜索、空间相交、轨迹分析、地图业务等空间查询。
  • 注意事项：空间索引、坐标系和几何合法性非常重要；复杂空间查询上线前需压测。

postgis_raster​

  • 名称：postgis_raster
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：PostGIS 栅格类型和函数。
  • 使用说明：用于栅格数据处理，例如遥感、地形、影像瓦片等空间栅格分析。
  • 注意事项：栅格数据体积通常较大，应评估存储、IO 和备份成本。

postgis_sfcgal​

  • 名称：postgis_sfcgal
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：PostGIS SFCGAL 函数。
  • 使用说明：用于高级几何运算和 3D 空间能力，补充 PostGIS 的复杂几何处理。
  • 注意事项：高级几何计算可能较耗 CPU；需确认数据合法性和性能边界。

postgis_tiger_geocoder​

  • 名称：postgis_tiger_geocoder
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：PostGIS tiger 地理编码和反向地理编码。
  • 使用说明：用于美国 TIGER 数据集相关地理编码和反向地理编码。
  • 注意事项：主要面向美国地址数据；非美国地区业务不应依赖该扩展。

postgis_topology​

  • 名称：postgis_topology
  • 版本：3.5.0
  • 访问链接：PostGIS 文档
  • 功能：PostGIS 拓扑空间类型和函数。
  • 使用说明：用于维护拓扑关系，例如边、面、节点之间的拓扑一致性。
  • 注意事项：拓扑模型维护成本高，适合 GIS 专业场景；普通位置查询通常使用 PostGIS geometry/geography 即可。

postgres_fdw​

  • 名称：postgres_fdw
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：查询远程 PostgreSQL 服务的外部数据封装器。
  • 使用说明：用于跨 PostgreSQL 实例查询、迁移、数据联邦或灰度迁移验证。
  • 注意事项：远程查询受网络和远端负载影响；需要管理 user mapping 和远程权限。

rdkit​

  • 名称：rdkit
  • 版本：4.7.0
  • 访问链接：RDKit 文档
  • 功能：化学信息学能力。
  • 使用说明：用于分子结构、指纹、相似度和化学检索，适合药物研发和化学数据管理。
  • 注意事项：属于专业领域扩展，数据模型和索引设计需要结合化学信息学规则验证。

rds_server_handler​

  • 名称：rds_server_handler
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：TencentDB PostgreSQL 服务处理扩展。
  • 使用说明：用于 TencentDB PostgreSQL 服务侧处理能力，通常服务于托管数据库内部运维或兼容场景。
  • 注意事项：一般不作为业务开发接口使用；使用前应确认控制台和产品文档支持边界。

refint​

  • 名称：refint
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：实现引用完整性的函数，已过时。
  • 使用说明：用于兼容旧系统中的引用完整性触发器逻辑。新项目应使用标准 foreign key。
  • 注意事项：已过时，不建议新业务使用；迁移旧表时应逐步替换为原生约束。

roaringbitmap​

  • 名称：roaringbitmap
  • 版本：0.5
  • 访问链接：GitHub
  • 功能：Roaring Bitmap 支持。
  • 使用说明：用于高效存储和计算大规模整数集合，适合人群包、标签集合和位图分析。
  • 注意事项：位图适合分析类集合运算，不适合替代明细表的事务读写。

rum​

  • 名称：rum
  • 版本：1.3
  • 访问链接：GitHub
  • 功能：RUM 索引访问方法。
  • 使用说明：用于全文检索和倒排索引增强，支持排名、位置等更复杂检索能力。
  • 注意事项：RUM 索引维护成本可能高于 GIN；写入频繁表需评估性能。

seg​

  • 名称：seg
  • 版本：1.4
  • 访问链接：PostgreSQL 文档
  • 功能：线段或浮点区间数据类型。
  • 使用说明：用于表达一维区间、线段或不确定数值范围。
  • 注意事项：只适合特定数值范围模型；通用范围类型可优先评估 PostgreSQL 原生 range 类型。

sequential_uuids​

  • 名称：sequential_uuids
  • 版本：1.0.2
  • 访问链接：PGXN
  • 功能：生成顺序 UUID。
  • 使用说明：用于生成更适合索引写入局部性的 UUID，降低随机 UUID 对 B-tree 的页分裂影响。
  • 注意事项：顺序 UUID 可能暴露生成顺序特征；对外 ID 仍需结合业务安全要求评估。

smlar​

  • 名称：smlar
  • 版本：1.0
  • 访问链接：GitHub
  • 功能：一维数组相似度计算。
  • 使用说明：用于数组之间的相似度比较，例如标签相似、推荐候选召回和集合去重。
  • 注意事项：数组相似度计算前应控制候选范围；大表全量比较成本较高。

sslinfo​

  • 名称：sslinfo
  • 版本：1.2
  • 访问链接：PostgreSQL 文档
  • 功能：SSL 证书信息。
  • 使用说明：用于查看当前连接的 SSL 证书和加密信息，辅助连接安全诊断。
  • 注意事项：该扩展用于诊断连接安全，不应作为应用层鉴权依据。

starrocks_fdw​

  • 名称：starrocks_fdw
  • 版本：1.2
  • 访问链接：腾讯云文档
  • 功能：查询 StarRocks 服务的外部数据封装器。
  • 使用说明：用于从 PostgreSQL 访问 StarRocks 数据，适合联邦查询、迁移验证或分析集成。
  • 注意事项：外部查询依赖 StarRocks 服务稳定性；大规模分析应在专用分析链路中完成。

tablefunc​

  • 名称：tablefunc
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：整表操作函数，包括 crosstab。
  • 使用说明：用于交叉表、透视表和特定整表转换，适合报表和分析查询。
  • 注意事项：透视结构通常依赖固定列集合；动态报表建议在应用层或 BI 工具中处理。

tcn​

  • 名称：tcn
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：触发式变更通知。
  • 使用说明：用于通过触发器发送表变更通知，适合轻量数据变更感知。
  • 注意事项：通知不是可靠消息队列；高可靠事件处理建议使用专门消息系统或业务事件表。

tencentdb_ai​

  • 名称：tencentdb_ai
  • 版本：1.3
  • 访问链接：腾讯云文档
  • 功能：腾讯云数据库 AI 扩展，可集成 prompt、embedding 等 AI 能力。
  • 使用说明：用于在数据库侧调用或集成 AI 能力，例如生成 embedding、处理 prompt 或构建智能查询辅助。
  • 注意事项：AI 调用可能产生额外延迟和成本；敏感数据进入模型前需评估合规和脱敏。

tencentdb_failover_slot​

  • 名称：tencentdb_failover_slot
  • 版本：1.1
  • 访问链接：腾讯云文档
  • 功能：故障切换 slot 相关函数。
  • 使用说明：用于故障切换场景下复制槽相关处理，服务于高可用和复制链路维护。
  • 注意事项：通常由数据库运维使用；错误操作可能影响复制或 WAL 保留。

tencentdb_index_advisor​

  • 名称：tencentdb_index_advisor
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：TencentDB PostgreSQL 查询和工作负载级索引顾问。
  • 使用说明：用于根据单条 SQL 或工作负载分析索引建议，辅助查询优化。
  • 注意事项：索引建议需要结合写入成本、存储成本和真实 workload 验证，不应自动全量采纳。

tencentdb_serverless​

  • 名称：tencentdb_serverless
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：serverless 模式支持扩展。
  • 使用说明：用于 TencentDB PostgreSQL serverless 模式相关能力支持。
  • 注意事项：通常属于产品运行时能力，不建议业务 SQL 直接依赖其内部行为。

tencentdb_sql_throttling​

  • 名称：tencentdb_sql_throttling
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：跟踪 SQL 计划与执行统计。
  • 使用说明：用于 SQL 统计、限流或执行观测相关能力，辅助治理异常 SQL。
  • 注意事项：限流策略应谨慎配置，避免误伤核心业务；变更前建议灰度验证。

tencentdb_superuser​

  • 名称：tencentdb_superuser
  • 版本：1.1
  • 访问链接：腾讯云文档
  • 功能：升级支持扩展。
  • 使用说明：用于 TencentDB PostgreSQL 升级或托管运维相关支持。
  • 注意事项：通常不作为业务功能使用；不要在应用逻辑中依赖该扩展。

tencentdb_system_stat​

  • 名称：tencentdb_system_stat
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：跟踪 SQL 执行统计。
  • 使用说明：用于采集数据库系统级 SQL 执行统计，辅助性能分析。
  • 注意事项：统计信息用于诊断和趋势分析；不要在高频业务路径中反复查询大范围统计视图。

tencentdb_wal_stat​

  • 名称：tencentdb_wal_stat
  • 版本：1.0
  • 访问链接：腾讯云文档
  • 功能：按关系聚合 WAL 统计。
  • 使用说明：用于分析不同表或索引产生的 WAL 写入量，辅助判断写放大和复制压力。
  • 注意事项：WAL 统计用于运维分析；处理结果时注意与业务写入峰值、索引数量和批处理关联。

timescaledb​

  • 名称：timescaledb
  • 版本：2.23.0
  • 访问链接：TimescaleDB 文档
  • 功能：时序数据扩展，支持高吞吐写入和复杂查询。
  • 使用说明：用于指标、事件、IoT、日志等时序数据建模，支持 hypertable、时间分区和时序聚合能力。
  • 注意事项：需要按时间维度设计数据模型和保留策略；高基数标签和压缩策略需单独评估。

topn​

  • 名称：topn
  • 版本：2.6.0
  • 访问链接：GitHub
  • 功能：Top-N JSONB 类型。
  • 使用说明：用于维护 JSONB 形式的 Top-N 统计结果，适合热门项、排名和近似榜单分析。
  • 注意事项：适合分析聚合，不适合需要严格顺序和精确排名的交易场景。

tsm_system_rows​

  • 名称：tsm_system_rows
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：按行数限制的 TABLESAMPLE 方法。
  • 使用说明：用于按指定行数从表中采样，适合快速抽样检查和测试数据分析。
  • 注意事项：采样结果不保证完全随机均匀；不应用于需要严格统计置信度的场景。

tsm_system_time​

  • 名称：tsm_system_time
  • 版本：1.0
  • 访问链接：PostgreSQL 文档
  • 功能：按时间限制的 TABLESAMPLE 方法。
  • 使用说明：用于按执行时间预算从表中采样，适合大表快速预览。
  • 注意事项：结果受页面布局和执行时间影响，不适合精确统计。

unaccent​

  • 名称：unaccent
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：移除重音字符的全文检索字典。
  • 使用说明：用于搜索中忽略重音符号，例如让 cafe 和 café 可匹配。
  • 注意事项：主要解决拉丁字符重音问题；中文分词应使用 zhparser 或 pg_jieba。

uuid-ossp​

  • 名称：uuid-ossp
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：生成 UUID。
  • 使用说明：用于生成 UUID v1/v3/v4/v5 等标识符，适合作为分布式主键或外部 ID。
  • 注意事项：随机 UUID 可能影响 B-tree 写入局部性；高写入表可评估顺序 UUID 或 bigint identity。

vector​

  • 名称：vector
  • 版本：0.8.2
  • 访问链接：GitHub
  • 功能：向量数据类型和 ivfflat、hnsw 索引方法。
  • 使用说明：用于存储 embedding 并进行向量相似度检索，适合 RAG、语义搜索和推荐。
  • 注意事项：向量维度必须与模型一致；索引类型、距离函数和元数据过滤需要一起设计。

vectorscale​

  • 名称：vectorscale
  • 版本：0.9.0
  • 访问链接：GitHub
  • 功能：用于向量搜索的 diskann 访问方法。
  • 使用说明：用于更大规模向量检索场景，基于 diskann 访问方法扩展向量搜索能力。
  • 注意事项：适合大规模向量数据；需要评估召回率、索引构建时间、磁盘和查询延迟。

xml2​

  • 名称：xml2
  • 版本：1.1
  • 访问链接：PostgreSQL 文档
  • 功能：XPath 查询和 XSLT 支持。
  • 使用说明：用于查询和转换 XML 数据，适合兼容 XML 格式的历史系统或数据交换。
  • 注意事项：新业务通常优先使用 JSON/JSONB；XML 查询应注意输入可信度和性能。

zhparser​

  • 名称：zhparser
  • 版本：2.2
  • 访问链接：GitHub
  • 功能：中文全文检索解析器。
  • 使用说明：用于中文文本分词和全文检索配置，适合中文文章、商品、工单、知识库搜索。
  • 注意事项：词典和分词效果决定搜索质量；上线前需要用真实中文语料验证。