CONFIGURATION PARAMETER客户端连接默认值 / 其他默认值
dynamic_library_path
设置动态可加载模块的搜索路径。
Sets the path for dynamically loadable modules.
字符串 会话（超级用户） 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 字符串string
- 上下文
- 会话（超级用户）超级用户可在会话内用 SET 修改
- 默认值
$libdir- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 15 完全一致，下面就是同一段文字。
如果需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令中指定的文件名没有目录部分（即名字中不包含斜线），那么系统将搜索这个路径以查找所需的文件。
参数dynamic_library_path的值必须是由冒号（Windows上为分号）分隔的绝对目录路径列表。如果某个列表元素以特殊字符串$libdir开头，则会使用编译时确定的PostgreSQL软件包的库目录来替换$libdir；该目录是标准PostgreSQL发行版所提供模块的安装位置。（使用pg_config --pkglibdir可以找出此目录的名称。）例如：
dynamic_library_path = '/usr/local/lib/postgresql:/home/my_project/lib:$libdir'
或者，在 Windows 环境中：
dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
这个参数的默认值是'$libdir'。如果该值被设置为一个空字符串，则关闭自动路径搜索。
这个参数可以由超级用户和具有适当SET权限的用户在运行时更改，但以这种方式进行的设置只会持续到客户端连接结束，因此这种方法应该保留用于开发目的。推荐设置此参数的方法是在postgresql.conf配置文件中。
机制详解
dynamic_library_path：设置动态可加载模块的搜索路径。只有模块名不含目录部分时才使用该搜索路径；$libdir 指向 PostgreSQL 版本对应的库目录。
dynamic_library_path 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。
库发现与预加载会和已安装二进制版本、扩展控制文件、服务器或后端启动，以及模块自身 GUC 相互作用。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把 dynamic_library_path 限制在管理员控制且版本匹配的目录，并保留 $libdir；只有部署与回滚显式管理时才使用绝对模块路径。
-
OLAP分析与批处理
只有经过评审的分析扩展软件包在所有故障转移目标完全一致时才新增搜索目录。
-
小规格低配实例与开发机
保持 $libdir；扩大本地代码搜索路径没有容量收益，只会增加打包与信任风险。
常见问题
- 只在一个会话中修改 dynamic_library_path，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
- 指定缺失或 ABI 不兼容模块，导致连接失败或服务器无法启动。
- 把搜索或预加载路径当作无害配置，忽略它决定服务器信任哪些本地代码。
- 没有回滚计划及客户端或运维兼容测试，就全局修改 dynamic_library_path。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.1 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.2 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.3 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.4 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.5 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 9.6 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 10 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 11 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 12 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 13 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 14 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 15 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 16 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 17 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 18 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 19 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
| 20 沿用 | $libdir |
— |
会话（超级用户） |
字符串 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 其他默认值 3 | |||||
dynamic_library_path |
字符串 | 会话（超级用户） | $libdir |
— | |
| 设置动态可加载模块的搜索路径。 | 现存 | ||||
extension_control_path |
字符串 | 会话（超级用户） | $system |
— | |
| 设置扩展控制文件的搜索路径。 | 现存 | ||||
gin_fuzzy_search_limit |
整数 | 会话 | 0 |
— | |
| 设置 GIN 精确搜索允许返回的最大结果数。 | 现存 | ||||