其他缺省
主要介绍数据库系统默认的库加载参数。
dynamic_library_path
参数说明: 设置数据查找动态加载的共享库文件的路径。当需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令里面声明的名称没有目录部分时,系统将搜索这个目录以查找声明的文件。
用于dynamic_library_path的数值必须是一个冒号分隔的绝对路径列表。当一个路径名称以特殊变量$libdir为开头时,会替换为openGauss发布提供的模块安装路径。例如:
dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir'该参数属于SUSET类型参数,请参考表2中对应设置方法进行设置。
取值范围: 字符串
说明
设置为空字符串,表示关闭自动路径搜索。
配置 shared_preload_libraries 时,需结合库名的写法设置 dynamic_library_path:
- 使用
a.so、b.so等不含目录的库名时,应确保搜索路径包含库文件所在目录。可以使用$libdir表示标准模块安装目录。 - 将搜索路径设为空字符串后,不再通过本参数查找这些库,也不会自动回退到
$libdir。如果预加载库无法定位到可加载的文件,服务器启动失败。空字符串是合法取值,但不保证它与任意预加载库列表组合后都能成功启动。 - 使用绝对路径或
$libdir/a等含目录的库名时,直接解析指定路径,不依赖本参数的搜索目录列表;空搜索路径不会禁止这种显式路径加载。库文件仍需存在、可访问并与服务器兼容。
详情请参见 shared_preload_libraries。
默认值: $libdir
gin_fuzzy_search_limit
参数说明: 设置GIN索引返回的集合大小的上限。
该参数属于USERSET类型参数,请参考表2中对应设置方法进行设置。
取值范围: 整型,0~2147483647
默认值: 0
local_preload_libraries
参数说明: 指定一个或多个共享库,它们在开始连接前预先加载。多个加载库之间用逗号分隔,除了双引号,所有的库名都转换为小写。
- 并非只有系统管理员才能更改此选项,因此只能加载安装的标准库目录下plugins子目录中的库文件,数据库管理员有责任确保该目录中的库都是安全的。local_preload_libraries中指定的项可以明确含有该目录,例如
libdir/plugins/mylib)。 - 与shared_preload_libraries不同,在会话开始之前加载模块与在会话中使用到该模块的时候临时加载相比并不具有性能优势。相反,这个特性的目的是为了调试或者测量在特定会话中不明确使用LOAD加载的库。例如针对某个用户将该参数设为ALTER USER SET来进行调试。
- 当指定的库未找到时,连接会失败。
- 每一个支持openGauss的库都有一个“magic block”用于确保兼容性,因此不支持openGauss的库不能通过这个方法加载。
该参数属于BACKEND类型参数,请参考表2中对应设置方法进行设置。
取值范围: 字符串
默认值: 空