更新时间:2026-10-21 GMT+08:00
分享

其他缺省

主要介绍数据库系统默认的库加载参数。

dynamic_library_path

参数说明:设置数据查找动态加载的共享库文件的路径。当需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令里面声明的名称没有目录部分时,系统将搜索这个目录以查找声明的文件,仅sysadmin用户可以访问。

参数类型:字符串

参数单位:无

取值范围:用冒号分隔(Windows下是分号分隔)的绝对路径列表。

当一个路径名称以特殊变量$libdir为开头时,会替换为GaussDB发布提供的模块安装路径。例如:
1
dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir'

设置为空字符串时,表示关闭自动路径搜索。

默认值:"$libdir"

设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。

设置建议:推荐使用默认值。

设置不当的风险与影响:由于参数local_preload_libraries和shared_preload_libraries配置的动态库的搜索路径也依赖此参数配置,如果设置此参数为空或其他非法路径会导致动态库加载失败,从而导致数据库服务异常。

gin_fuzzy_search_limit

参数说明:设置UGIN或GIN索引返回的集合大小的软上限。当此参数为非默认值时,UGIN索引扫描时将会报错。

参数类型:整型

参数单位:无

取值范围:0 ~ 2147483647

默认值:0

设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。

设置建议:推荐使用默认值。

设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。

enable_astore_gin

参数说明:GIN索引功能开关。当开关打开时,Astore支持创建GIN索引;当开关关闭时,GIN索引功能不可用。

参数类型:布尔型

参数单位:无

取值范围:

  • on:表示Astore支持GIN功能打开。
  • off:表示Astore支持GIN功能关闭。

默认值:on

设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。

设置建议:建议保持默认值,根据实际业务调整。

设置不当的风险与影响:无

enable_astore_gist

参数说明:GiST索引功能开关。当开关打开时,Astore支持创建GiST索引;当开关关闭时,GiST索引功能不可用。

参数类型:布尔型

参数单位:无

取值范围:
  • on:表示Astore支持GiST功能打开。
  • off:表示Astore支持GiST功能关闭。

默认值:on

设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。

设置建议:建议保持默认值,根据实际业务调整。

设置不当的风险与影响:无

local_preload_libraries

参数说明:指定一个或多个共享库,它们在开始连接前预先加载。多个共享库之间用逗号分隔,除了双引号内的库名,所有的库名都转换为小写。

  • 并非只有系统管理员才能更改此选项,因此只能加载安装的标准库目录下plugins子目录中的库文件,数据库管理员有责任确保该目录中的库都是安全的。local_preload_libraries中指定的项可以明确含有该目录,例如$libdir/plugins/mylib;也可以仅指定库的名称,例如mylib(等价于$libdir/plugins/mylib)。
  • 与shared_preload_libraries不同,在会话开始之前加载模块与在会话中使用到该模块的时候临时加载相比并不具有性能优势。相反,这个特性的目的是为了调试或者测量在特定会话中不明确使用LOAD加载的库。例如针对某个用户将该参数设为ALTER USER SET来进行调试。
  • 每一个支持GaussDB的库都有一个“magic block”用于确保兼容性,因此不支持GaussDB的库不能通过这个方法加载。

参数类型:字符串

参数单位:无

取值范围:用逗号分隔的共享库列表,或空字符串。

默认值:""

设置方式:该参数属于BACKEND类型参数,请参见表1中对应设置方法进行设置。

设置建议:推荐使用默认值。

设置不当的风险与影响:当指定的库未找到时,连接会失败。若误设置出错(包括长度超过限制、非法目录等),会影响进程正常拉起。

enable_driver_param_sync

参数说明:控制驱动创建数据库连接时指定的GUC参数是否从CN同步到DN。

参数类型:布尔型

参数单位:无

取值范围:

  • on:表示开启。
  • off:表示关闭。

默认值:升级上来的数据库实例默认为off,新安装的数据库实例默认为on。

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。

设置建议:推荐使用默认值,升级上来的数据库建议在业务评估影响后手动设置为on。

设置不当的风险与影响:当参数为off时,驱动创建连接时设置的参数在执行RESET ALL命令后,CN上的参数取值还原为连接中设置的参数,而DN上的参数取值还原为参数默认值,此时存在CN和DN取值不一样的问题。因此建议升级上来的数据库在业务评估影响后手动设置为on,避免出现参数不一致问题。

相关文档