-
runtime_filter_type 参数说明:标识使用的runtime filter类型。 取值范围:字符串 all,表示应用除global_filter外的runtime filter。 min_max,表示仅应用join场景下的runtime filter,且join场景仅会生成min_max过滤器。 bloom_filter,表示仅应用join场景下的runtime filter,且满足条件后join会生成bloom filter进行过滤。 topn_filter,表示应用join场景以及带有limit的order by场景下的runtime filter,外表不生效。 global_filter:表示应用join场景下,跨dn节点的runtime filter,开启后支持runtime filter对不同dn上的数据生成min_max/bloom_filter过滤器。 none,表示不使用runtime filter,此时仅对原版bloom filter生效场景具有过滤效果。 默认值:none
-
enable_spill_to_remote_storage 参数说明:控制是否打开spill-to-obs特性开关,为true时表示开启特性,下盘数据会被disk cache管控,并在空间不足时使用OBS作为逃生通道;为false时表示使用旧的下盘方式,直接写到本地EVS中。该参数存在参数依赖,当打开spill-to-obs特性开关enable_spill_to_remote_storage时,use_yr_as_block_cache_backend开关必须为false。 取值范围: bool on/true表示开启。 off/false表示关闭。 默认值:false 由于spill-to-obs特性依赖的元戎相关能力(如append buf)在25.3.0版本暂时无法提供,当前存在特性使用限制,当打开enable_spill_to_remote_storage时,diskcache的存储后端当前无法使用元戎数据系统,请设置use_yr_as_block_cache_backend开关为false后再启用spill-to-obs特性。 use_yr_as_block_cache_backend为false时,意味着近计算缓存会直接使用DN实例下的目录来缓存数据,此时注意系统盘的空间问题, 此时建议将function-agent中存放DN实例的路径映射在大容量的物理EVS盘中,避免系统盘空间不足导致的pod被驱逐的问题。
-
search_path 参数说明:当一个被引用对象没有指定模式时,此参数设置模式搜索顺序。它的值由一个或多个模式名构成,不同的模式名用逗号隔开。 当前会话存放临时表的模式时,可以使用别名pg_temp将它列在搜索路径中,如'pg_temp,public' 。 存放临时表的模式始终会作为第一个被搜索的对象,排在pg_catalog和search_path中所有模式的前面,即具有第一搜索优先级。建议用户不要在search_path中显式设置pg_temp。如果在search_path中指定了pg_temp,但不是在最前面,系统会提示设置无效,pg_temp仍被优先搜索。通过使用别名pg_temp,系统只会在存放临时表的模式中搜索表、视图和数据类型这样的数据库对象,不会在里面搜索函数或运算符这样的数据库对象。 系统表所在的模式pg_catalog,总是排在search_path中指定的所有模式前面被搜索,即具有第二搜索优先级(pg_temp具有第一搜索优先级)。建议用户不要在search_path中显式设置pg_catalog。如果在search_path中指定了pg_catalog,但不是在最前面,系统会提示设置无效,pg_catalog仍被第二优先搜索。 当没有指定一个特定模式而创建一个对象时,它们被放置到以search_path为命名的第一个模式中。当搜索路径为空时,会报错误。 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同,因为current_schema显示search_path中首位有效的模式名称。 取值范围:字符串 设置为空串('')的时候,系统会自动转换成一对双引号。 设置的内容中包含双引号,系统会认为是不安全字符,会将每个双引号转换成一对双引号。 默认值:default_db
-
dynamic_library_path 参数说明:设置数据查找动态加载的共享库文件的路径。当需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令里面声明的名称没有目录部分时,系统将搜索这个目录以查找声明的文件,仅sysadmin用户可以访问。该参数可在PDB级别设置。 参数类型:字符串 参数单位:无 取值范围:用冒号分隔(Windows下是分号分隔)的绝对路径列表。 当一个路径名称以特殊变量$libdir为开头时,会替换为
GaussDB 发布提供的模块安装路径。例如: 1 dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir'
设置为空字符串时,表示关闭自动路径搜索。 默认值:"$libdir"。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置 设置建议:推荐使用默认值。 设置不当的风险与影响:由于参数local_preload_libraries和shared_preload_libraries配置的动态库的搜索路径也依赖此参数配置,如果设置此参数为空或其他非法路径会导致动态库加载失败,从而导致数据库服务异常。
-
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中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:当指定的库未找到时,连接会失败。若误设置出错(包括长度超过限制、非法目录等),会影响进程正常拉起。
-
gin_pending_list_limit 参数说明:设置当UGIN索引启用fastupdate时,UGIN索引pending list容量的最大值。当pending list的容量大于设置值时,会把pending list中数据批量移动到UGIN索引数据结构中以进行清理。单个UGIN索引可通过更改索引存储参数覆盖此设置值。该参数可在PDB级别设置。 参数类型:整型 参数单位:kB 取值范围:64 ~ 2147483647 默认值:4096(即4MB)。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值1024,表示gin_pending_list_limit为1024kB;带单位取值1MB,表示gin_pending_list_limit为1MB。取值如果要带单位,必须为kB、MB、GB。 设置建议:根据更新频率将此参数设置为合理的值,有助于提升UGIN索引同步修改的性能。 设置不当的风险与影响:该参数取值设置过大的情况下(大于work_mem),同步融合增量数据的性能以及扫描性能可能会变差。
-
statement_timeout 参数说明:当语句执行时间超过该参数设置的时间(从服务器收到命令时开始计时)时,该语句将会报错并退出执行。该参数可在PDB级别设置。 参数类型:整型 参数单位:ms(毫秒) 取值范围:0 ~ 2147483647 默认值:0,表示不开启超时报错功能。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。例如,不带单位取值2000,表示statement_timeout为2000ms;带单位取值2s,表示statement_timeout为2s。取值如果要带单位,必须为ms、s、min、h、d。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
-
vacuum_freeze_min_age 参数说明:VACUUM在扫描一个表时,用于判断是否用FrozenXID替换记录的xmin字段(在同一个事务中)的最小时间。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 2000000000 尽管随时可以将此参数设为上述取值范围之间的任意值,但是,VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 默认值:2000000000。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置偏大会使得freeze时间推迟,导致回收效率降低。
-
xmloption 参数说明:对XML数据进行隐式转换或序列化操作时,将其视为文档还是普通的字符串。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: document:表示HTML格式的文档。 content:表示普通的字符串。 默认值:content。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
-
max_compile_functions 参数说明:设置节点可存储的存储过程和函数的编译结果的最大数量,包括系统自带的存储过程、以及用户自定义的存储过程和函数。编译结果超过该参数的取值后,系统会自动触发内存淘汰,删除未使用的普通存储过程和函数。 参数类型:整型 参数单位:无 取值范围:1 ~ 2147483647 默认值:1000(196核CPU/1536G内存,128核CPU/1024G内存,104核CPU/1024G内存,96核CPU/1024G内存,96核CPU/768G内存,80核CPU/640G内存,64核CPU/512G内存,60核CPU/480G内存,32核CPU/256G内存,16核CPU/128G内存,8核CPU/64G内存,4核CPU/32G内存);10(4核CPU/16G内存) 设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,有助于减少内存占用,提升系统性能。 设置不当的风险与影响:编译结果数量超过该参数设定的值后,若系统一直找不到适合删除的存储过程和函数,会占用大量内存,导致性能下降。
-
vacuum_freeze_table_age 参数说明:指定VACUUM扫描全表以冻结元组的时间。如果当前事务号与表pg_class.relfrozenxid64字段的差值已经大于参数指定的时间,则VACUUM会对全表进行扫描。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 2000000000 尽管随时可以将此参数设为上述取值范围之间的任意值,但是,VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期手动执行VACUUM可以在对此表的反重叠自动清理启动之前运行。 默认值:4000000000。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:设置偏大可能导致表空间膨胀。
-
bytea_output 参数说明:设置bytea类型值的输出格式。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: hex:将二进制数据编码为每字节2位十六进制数字。 escape:采用以ASCII字符序列表示二进制串的方法,同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 默认值:hex。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
-
xmlbinary 参数说明:设置二进制值在XML中的编码格式。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: base64:使用base64编码格式。 hex:使用hex编码格式。 默认值:base64。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
-
temp_tablespaces 参数说明:当一个CREATE命令没有明确指定一个表空间时,temp_tablespaces指定了创建临时对象(临时表和临时表的索引)所在的表空间。在这些表空间中创建临时文件用来做大型数据的排序工作。该参数可在PDB级别设置。 其值是一系列表空间名的列表。如果列表中有多个表空间时,每次临时对象的创建,GaussDB会在列表中随机选择一个表空间;如果在事务中,连续创建的临时对象被放置在列表里连续的表空间中。如果选择的列表中的元素是一个空字符串,GaussDB将自动将当前的数据库设为默认的表空间。 参数类型:字符串 参数单位:无 取值范围:已有表空间的名称或空字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建,请参考default_tablespace。 默认值:""。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
-
default_transaction_isolation 参数说明:设置默认的事务隔离级别。该参数可在PDB级别设置。 当前版本暂不支持设置默认的事务隔离级别,默认为read committed,请勿自行修改。 参数类型:枚举类型 参数单位:无 取值范围: read committed:表示事务读已提交。 read uncommitted:表示事务读未提交。 repeatable read:表示事务可重复读。 serializable:GaussDB目前功能上不支持此隔离级别,等价于repeatable read。 默认值:read committed。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。