受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

Appendix F. 额外提供的模块与扩展

Table of Contents

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-树行为的 GIN 操作符类
F.7.1. 用法示例
F.7.2. 作者
F.8. btree_gist — 具有 B-树行为的 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-树函数
F.23.4. BRIN 函数
F.23.5. GIN 函数
F.23.6. GiST 函数
F.23.7. 哈希函数
F.24. passwordcheck — 验证密码强度
F.24.1. 配置参数
F.25. pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态
F.25.1. pg_buffercache 视图
F.25.2. pg_buffercache_summary() 函数
F.25.3. pg_buffercache_usage_counts() 函数
F.25.4. 示例输出
F.25.5. 作者
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_prewarm — 将关系数据预热到缓冲区缓存中
F.28.1. 函数
F.28.2. 配置参数
F.28.3. 作者
F.29. pgrowlocks — 显示表的行锁信息
F.29.1. 概述
F.29.2. 示例输出
F.29.3. 作者
F.30. pg_stat_statements — 跟踪 SQL 计划和执行统计信息
F.30.1. pg_stat_statements 视图
F.30.2. pg_stat_statements_info 视图
F.30.3. 函数
F.30.4. 配置参数
F.30.5. 示例输出
F.30.6. 作者
F.31. pgstattuple — 获取元组级统计信息
F.31.1. 函数
F.31.2. 作者
F.32. pg_surgery — 对关系数据执行底层手术
F.32.1. 函数
F.32.2. 作者
F.33. pg_trgm — 基于三元组匹配的文本相似度支持
F.33.1. 三元组(Trigram 或 Trigraph)概念
F.33.2. 函数和操作符
F.33.3. GUC 参数
F.33.4. 索引支持
F.33.5. 文本搜索集成
F.33.6. 参考
F.33.7. 作者
F.34. pg_visibility — 可见性映射信息与工具
F.34.1. 函数
F.34.2. 作者
F.35. pg_walinspect — WAL 的底层检查
F.35.1. 通用函数
F.35.2. 作者
F.36. postgres_fdw — 访问存储在外部 PostgreSQL 服务器中的数据
F.36.1. postgres_fdw 的 FDW 选项
F.36.2. 函数
F.36.3. 连接管理
F.36.4. 事务管理
F.36.5. 远程查询优化
F.36.6. 远程查询执行环境
F.36.7. 跨版本兼容性
F.36.8. 等待事件
F.36.9. 配置参数
F.36.10. 示例
F.36.11. 作者
F.37. seg — 用于线段或浮点区间的数据类型
F.37.1. 原理
F.37.2. 语法
F.37.3. 精度
F.37.4. 用法
F.37.5. 注意
F.37.6. 致谢
F.38. sepgsql — 基于 SELinux 标签的强制访问控制(MAC)安全模块
F.38.1. 概述
F.38.2. 安装
F.38.3. 回归测试
F.38.4. GUC 参数
F.38.5. 特性
F.38.6. sepgsql 函数
F.38.7. 限制
F.38.8. 外部资源
F.38.9. 作者
F.39. spi — 服务器编程接口特性/示例
F.39.1. refint — 用于实现引用完整性的函数
F.39.2. autoinc — 用于字段自动递增的函数
F.39.3. insert_username — 用于跟踪谁修改了表的函数
F.39.4. moddatetime — 用于跟踪最后修改时间的函数
F.40. sslinfo — 获取客户端 SSL 信息
F.40.1. 提供的函数
F.40.2. 作者
F.41. tablefunc — 返回表的函数(crosstab 等)
F.41.1. 提供的函数
F.41.2. 作者
F.42. tcn — 用于向监听者通知表内容变更的触发器函数
F.43. test_decoding — 用于 WAL 逻辑解码的基于 SQL 的测试/示例模块
F.44. tsm_system_rows — TABLESAMPLESYSTEM_ROWS 采样方法
F.44.1. 示例
F.45. tsm_system_time — TABLESAMPLESYSTEM_TIME 采样方法
F.45.1. 示例
F.46. unaccent — 去除变音符号的文本搜索词典
F.46.1. 配置
F.46.2. 用法
F.46.3. 函数
F.47. uuid-ossp — UUID 生成器
F.47.1. uuid-ossp 函数
F.47.2. 构建uuid-ossp
F.47.3. 作者
F.48. xml2 — XPath 查询与 XSLT 功能
F.48.1. 弃用说明
F.48.2. 函数说明
F.48.3. xpath_table
F.48.4. XSLT 函数
F.48.5. 作者

本附录与下一附录包含有关 PostgreSQL 发行版中 contrib 目录中可选组件的信息。 这些组件包括移植工具、分析实用程序,以及不属于 PostgreSQL 核心系统的 插件功能。之所以将它们单独提供,主要是因为它们面向的受众有限, 或者实验性太强,不适合作为主源码树的一部分。但这并不影响它们的实用性。

本附录介绍位于 contrib 中的扩展以及其他服务器插件模块库。 Appendix G 介绍实用程序。

从源码发行版构建时,除非构建 world 目标 (见 Step 2),否则这些可选组件不会自动构建。 你可以在已配置好的源码树的 contrib 目录中运行:

make
make install

以构建并安装所有组件;若只想构建并安装某个选定的模块, 则可在该模块的子目录中执行同样的命令。 许多模块都带有回归测试,可以在安装前运行:

make check

或在 PostgreSQL 服务器已经运行后运行:

make installcheck

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

许多组件提供新的用户定义函数、操作符或类型,并将其打包为 扩展。 安装代码后,要使用其中某个扩展,就需要在数据库系统中注册新的 SQL 对象。 这可通过执行 CREATE EXTENSION 命令完成。 在一个新建的数据库中,你可以直接执行:

CREATE EXTENSION extension_name;

该命令只会在当前数据库中注册这些新的 SQL 对象,因此需要在每个希望使用该 扩展功能的数据库中运行它。另一种做法是在 template1 数据库中运行它,这样该扩展默认会被复制到随后创建的数据库中。

对于所有扩展,除非该扩展被视为 trusted,否则 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。 详情见各组件文档。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。