2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不受支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

附录 F. 附加提供的模块和扩展

目录

F.1. amcheck — 检查表和索引一致性的工具
F.1.1. 函数
F.1.2. 可选 heapallindexed 验证
F.1.3. 有效使用 amcheck
F.1.4. 修复损坏
F.2. auth_delay — 认证失败时暂停
F.2.1. 配置参数
F.2.2. 作者
F.3. auto_explain — 记录慢查询的执行计划
F.3.1. 配置参数
F.3.2. 示例
F.3.3. 作者
F.4. basebackup_to_shell — 示例 "shell" pg_basebackup 模块
F.4.1. 配置参数
F.4.2. 作者
F.5. basic_archive — 示例 WAL 归档模块
F.5.1. 配置参数
F.5.2. 注意
F.5.3. 作者
F.6. bloom — 布隆过滤器索引访问方法
F.6.1. 参数
F.6.2. 示例
F.6.3. 操作符类接口
F.6.4. 限制
F.6.5. 作者
F.7. btree_gin — 具有 B-tree 行为的 GIN 操作符类
F.7.1. 示例用法
F.7.2. 作者
F.8. btree_gist — 具有 B-tree 行为的 GiST 操作符类
F.8.1. 示例用法
F.8.2. 作者
F.9. citext — 忽略大小写的字符串类型
F.9.1. 基本原理
F.9.2. 如何使用
F.9.3. 字符串比较行为
F.9.4. 限制
F.9.5. 作者
F.10. cube — 多维立方体数据类型
F.10.1. 语法
F.10.2. 精度
F.10.3. 用法
F.10.4. 默认值
F.10.5. 注意
F.10.6. 致谢
F.11. dblink — 连接到其他 PostgreSQL 数据库
dblink_connect — 打开到远程数据库的持久连接
dblink_connect_u — 不安全地打开到远程数据库的持久连接
dblink_disconnect — 关闭到远程数据库的持久连接
dblink — 在远程数据库中执行查询
dblink_exec — 在远程数据库中执行命令
dblink_open — 在远程数据库中打开游标
dblink_fetch — 从远程数据库的打开游标中返回行
dblink_close — 关闭远程数据库的游标
dblink_get_connections — 返回所有已打开的命名 dblink 连接的名称
dblink_error_message — 获取命名连接上的最后一条错误消息
dblink_send_query — 向远程数据库发送异步查询
dblink_is_busy — 检查连接是否正忙于异步查询
dblink_get_notify — 在连接上检索异步通知
dblink_get_result — 获取异步查询结果
dblink_cancel_query — 取消命名连接上任何活动的查询
dblink_get_pkey — 返回关系主键字段的位置和字段名
dblink_build_sql_insert — 使用本地元组构建 INSERT 语句,用提供的替代值替换主键字段值
dblink_build_sql_delete — 使用提供的值构建 DELETE 语句,用于主键字段值
dblink_build_sql_update — 使用本地元组构建 UPDATE 语句,用提供的替代值替换主键字段值
F.12. dict_int — 整数的全文本搜索字典示例
F.12.1. 配置
F.12.2. 用法
F.13. dict_xsyn — 同义词全文本搜索字典示例
F.13.1. 配置
F.13.2. 用法
F.14. earthdistance — 计算大圆距离
F.14.1. 基于立方体的地球距离
F.14.2. 基于点的地球距离
F.15. file_fdw — 访问服务器文件系统中的数据文件
F.16. fuzzystrmatch — 确定字符串相似度和距离
F.16.1. Soundex
F.16.2. Daitch-Mokotoff Soundex
F.16.3. Levenshtein
F.16.4. Metaphone
F.16.5. Double Metaphone
F.17. hstore — hstore 键/值数据类型
F.17.1. hstore 外部表示
F.17.2. hstore 操作符和函数
F.17.3. 索引
F.17.4. 示例
F.17.5. 统计信息
F.17.6. 兼容性
F.17.7. 转换
F.17.8. 作者
F.18. intagg — 整数聚合器和枚举器
F.18.1. 函数
F.18.2. 示例用途
F.19. intarray — 操作整数数组
F.19.1. intarray 函数和操作符
F.19.2. 索引支持
F.19.3. 示例
F.19.4. 基准测试
F.19.5. 作者
F.20. isn — 国际标准数字(ISBN、EAN、UPC 等)的数据类型
F.20.1. 数据类型
F.20.2. 转换
F.20.3. 函数和操作符
F.20.4. 配置参数
F.20.5. 示例
F.20.6. 参考资料
F.20.7. 作者
F.21. lo — 管理大对象
F.21.1. 基本原理
F.21.2. 如何使用
F.21.3. 限制
F.21.4. 作者
F.22. ltree — 分层树状数据类型
F.22.1. 定义
F.22.2. 操作符和函数
F.22.3. 索引
F.22.4. 示例
F.22.5. 转换
F.22.6. 作者
F.23. pageinspect — 数据库页面的低级检查
F.23.1. 通用函数
F.23.2. 堆函数
F.23.3. B-tree 函数
F.23.4. BRIN 函数
F.23.5. GIN 函数
F.23.6. GiST 函数
F.23.7. Hash 函数
F.24. passwordcheck — 检查密码强度
F.24.1. 配置参数
F.25. pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态
F.25.1. pg_buffercache 视图
F.25.2. pg_buffercache_numa 视图
F.25.3. pg_buffercache_summary() 函数
F.25.4. pg_buffercache_usage_counts() 函数
F.25.5. pg_buffercache_evict() 函数
F.25.6. pg_buffercache_evict_relation() 函数
F.25.7. pg_buffercache_evict_all() 函数
F.25.8. 示例输出
F.25.9. 作者
F.26. pgcrypto — 加密函数
F.26.1. 通用哈希函数
F.26.2. 密码哈希函数
F.26.3. PGP 加密函数
F.26.4. 原始加密函数
F.26.5. 随机数据函数
F.26.6. OpenSSL 支持函数
F.26.7. 配置参数
F.26.8. 注意
F.26.9. 作者
F.27. pg_freespacemap — 检查空闲空间图
F.27.1. 函数
F.27.2. 示例输出
F.27.3. 作者
F.28. pg_logicalinspect — 逻辑解码组件检查
F.28.1. 函数
F.28.2. 作者
F.29. pg_overexplain — 允许 EXPLAIN 转储更多细节
F.29.1. EXPLAIN (DEBUG)
F.29.2. EXPLAIN (RANGE_TABLE)
F.29.3. 作者
F.30. pg_prewarm — 将关系数据预加载到缓冲区缓存中
F.30.1. 函数
F.30.2. 配置参数
F.30.3. 作者
F.31. pgrowlocks — 显示表的行锁定信息
F.31.1. 概述
F.31.2. 示例输出
F.31.3. 作者
F.32. pg_stat_statements — 跟踪 SQL 规划和执行的统计信息
F.32.1. pg_stat_statements 视图
F.32.2. pg_stat_statements_info 视图
F.32.3. 函数
F.32.4. 配置参数
F.32.5. 示例输出
F.32.6. 作者
F.33. pgstattuple — 获取元组级统计信息
F.33.1. 函数
F.33.2. 作者
F.34. pg_surgery — 对关系数据执行低级手术
F.34.1. 函数
F.34.2. 作者
F.35. pg_trgm — 支持使用三元组匹配确定文本相似度
F.35.1. 三元组(或三字母)概念
F.35.2. 函数和操作符
F.35.3. GUC 参数
F.35.4. 索引支持
F.35.5. 文本搜索集成
F.35.6. 参考资料
F.35.7. 作者
F.36. pg_visibility — 可见性图信息和工具
F.36.1. 函数
F.36.2. 作者
F.37. pg_walinspect — 低级 WAL 检查
F.37.1. 通用函数
F.37.2. 作者
F.38. postgres_fdw — 访问存储在外部 PostgreSQL 服务器中的数据
F.38.1. postgres_fdw 的 FDW 选项
F.38.2. 函数
F.38.3. 连接管理
F.38.4. 事务管理
F.38.5. 远程查询优化
F.38.6. 远程查询执行环境
F.38.7. 跨版本兼容性
F.38.8. 等待事件
F.38.9. 配置参数
F.38.10. 示例
F.38.11. 作者
F.39. seg — 线段或浮点区间的数据类型
F.39.1. 基本原理
F.39.2. 语法
F.39.3. 精度
F.39.4. 用法
F.39.5. 注意
F.39.6. 致谢
F.40. sepgsql — SELinux、基于标签的强制访问控制 (MAC) 安全模块
F.40.1. 概述
F.40.2. 安装
F.40.3. 回归测试
F.40.4. GUC 参数
F.40.5. 特性
F.40.6. Sepgsql 函数
F.40.7. 限制
F.40.8. 外部资源
F.40.9. 作者
F.41. spi — 服务器编程接口功能/示例
F.41.1. refint — 实现参照完整性的函数
F.41.2. autoinc — 自增字段的函数
F.41.3. insert_username — 跟踪谁修改了表的函数
F.41.4. moddatetime — 跟踪最后修改时间的函数
F.42. sslinfo — 获取客户端 SSL 信息
F.42.1. 提供的函数
F.42.2. 作者
F.43. tablefunc — 返回表的函数(crosstab 等)
F.43.1. 提供的函数
F.43.2. 作者
F.44. tcn — 一个触发器函数,用于通知监听器表内容的变化
F.45. test_decoding — 用于 WAL 逻辑解码的基于 SQL 的测试/示例模块
F.46. tsm_system_rows — TABLESAMPLESYSTEM_ROWS 采样方法
F.46.1. 示例
F.47. tsm_system_time — TABLESAMPLESYSTEM_TIME 采样方法
F.47.1. 示例
F.48. unaccent — 一个移除变音符号的文本搜索字典
F.48.1. 配置
F.48.2. 用法
F.48.3. 函数
F.49. uuid-ossp — UUID 生成器
F.49.1. uuid-ossp 函数
F.49.2. 构建 uuid-ossp
F.49.3. 作者
F.50. xml2 — XPath 查询和 XSLT 功能
F.50.1. 弃用通知
F.50.2. 函数描述
F.50.3. xpath_table
F.50.4. XSLT 函数
F.50.5. 作者

本附录和下一附录包含有关 PostgreSQL 分发版 contrib 目录中的可选组件的信息。这些组件包括移植工具、分析实用程序和插件功能,它们不是 PostgreSQL 核心系统的一部分。它们之所以单独存在,主要是因为它们面向的受众有限,或者过于实验性,无法成为主源树的一部分。但这并不妨碍它们的有用性。

本附录涵盖了 contrib 中的扩展和其他服务器插件模块库。 附录 G 涵盖了实用程序。

从源分发版构建时,这些可选组件不会自动构建,除非您构建 "world" 目标(请参阅 步骤 2)。您可以通过运行以下命令来构建和安装所有这些组件:

make
make install

在已配置的源树的 contrib 目录中;或者要仅构建和安装一个选定的模块,请在其子目录中执行相同的操作。许多模块都有回归测试,可以通过运行以下命令来执行:

make check

安装前或

make installcheck

一旦您运行了 PostgreSQL 服务器。

如果您使用的是预打包的 PostgreSQL 版本,这些组件通常会作为单独的子包提供,例如 postgresql-contrib

许多组件提供了新的用户定义函数、操作符或类型,它们被打包为 扩展。要使用其中一个扩展,在安装了所需代码后,您需要将新的 SQL 对象注册到数据库系统中。这可以通过执行 CREATE EXTENSION 命令来完成。在一个新的数据库中,您可以简单地执行:

CREATE EXTENSION extension_name;

此命令仅将新的 SQL 对象注册到当前数据库中,因此您需要在要使用该扩展功能的每个数据库中运行它。或者,在数据库 template1 中运行它,以便该扩展将默认复制到随后创建的数据库中。

对于所有扩展,CREATE EXTENSION 命令必须由数据库超级用户运行,除非该扩展被认为是 受信任的。受信任的扩展可以由任何对当前数据库具有 CREATE 权限的用户运行。受信任的扩展在以下各节中进行了标识。通常,受信任的扩展是那些不能提供对数据库外部功能的访问的扩展。

以下扩展在默认安装中是受信任的:

btree_gin fuzzystrmatch ltree tcn
btree_gist hstore pgcrypto tsm_system_rows
citext intarray pg_trgm tsm_system_time
cube isn seg unaccent
dict_int lo tablefunc uuid-ossp

许多扩展允许您将它们的对象安装到您选择的模式中。要做到这一点,在 CREATE EXTENSION 命令中添加 SCHEMA schema_name。默认情况下,对象将被放置在您当前的创建目标模式中,该模式默认为 public

但是请注意,其中一些组件不是这种意义上的 扩展,而是以其他方式加载到服务器中,例如通过 shared_preload_libraries。有关详细信息,请参阅每个组件的文档。

提交更正

如果您在文档中发现任何不正确的内容,与您对特定功能的体验不符,或需要进一步澄清,请使用 此表单 报告文档问题。