文档首页/ 云数据库 GaussDB/ 用户指南/ 参数管理/ 数据库实例支持修改的参数
更新时间:2024-08-09 GMT+08:00
分享

数据库实例支持修改的参数

本章节介绍GaussDB数据库实例支持修改的实例参数。

支持修改的参数如下:

表1 分布式独立部署参数

参数名称

描述

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:recovery_max_workers

并行回放线程个数。

cn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

cn:behavior_compat_options

数据库兼容性行为配置项。proc_outparam_override选项行为变更后,业务需要重新建立连接或者重新启动集群,否则无法正确调用存储过程和函数。

dn:recyclebin_retention_time

设置回收站对象保留时间,超过该时间的回收站对象将被自动清理。单位为秒。

dn:track_stmt_session_slot

设置一个session缓存的最大的全量/慢SQL的数量,超过这个数量,新的语句执行将不会被跟踪,直到落盘线程将缓存语句落盘,留出空闲的空间。推荐设置为默认值。

timezone

设置显示和解释时间类型数值时使用的时区。

cn:auto_increment_offset

自动增长列的起始值,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若大于auto_increment_increment自动增长列自增时会产生错误。

dn:enable_xid_abort_check

事务提交时校验事务ID回滚开关是否开启。

cn:audit_internal_event

该参数决定是否审计内部工具cm_agent、gs_clean、WDRXdb的连接及进行的操作、DN上是否对来自CN的登入登出进行审计。

cn:codegen_compile_thread_num

该参数用于设置Codegen编译线程的线程数量。

dn:static_thread_pool_num

线程个数,表示用于创建静态线程池(静态池)的线程个数。该参数仅在enable_thread_pool打开后分布式CN上生效。

cn:auto_increment_increment

自动增长列的自增步长,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若小于auto_increment_offset自动增长列自增时会产生错误。

cn:sql_mode

M-Compatibility模式下SQL行为控制配置项。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

cn:llvm_max_memory

此参数仅限制Codegen执行方式下,编译产生的IR(包括缓存的和正在使用的)内存使用上限。Codegen使用的内存不采用预占的方式申请,属于max_dynamic_memory的一部分,且受llvm_max_memory参数的限制。单位为KB。

cn:hll_default_log2explicit

该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。

dn:fix_func_selection

是否优化函数匹配策略。选项值catlist: 优化catlist顺序问题;(对非B兼容模式进行优化,非B兼容模式下始终优先选择系统函数并执行。B兼容模式与505.1.0版本之前的版本保持一致,可能提示函数不唯一的错误,也可能选中系统函数进行执行)

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

global_syscache_threshold

全局系统缓存占用内存上限。建议设置在平均每个DB 2048-16384 KB范围内,设置过大可能会导致cache链过长,导致性能下降,设置太小,参数不生效,实际占用内存超出阈值限制,性能下降。单位为KB。

dn:sql_mode

M-Compatibility模式下SQL行为控制配置项。

dn:verify_log_buffers

控制内存态verify log buffers大小,代表页数,单位为8kB。例如:数值为4时,代表申请内存为4 * 8kB = 32kB。仅在page_version_check为persistence下生效。page_version_check为非persistence时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为persistence时才会真正生效。

dn:resilience_ctrlstmt_control_iopslimit

正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 0(None):表示不对IOPS做限制。 10(LOW):表示对IOPS限制等级为LOW。 20(MEDIUM):表示对IOPS限制等级为MEDIUM。 50(HIGH):表示对IOPS限制等级为HIGH。

cn:convert_illegal_char_mode

用于在enable_convert_illegal_char参数开启时,设置客户端显示非法编码的占位符。取值范围为ascii编码表中十进制编码为32至126的95个可显示字符。

cn:page_version_check

启用页面版本校验功能类型。off表示关闭页面版本校验功能。memory表示开启纯内存态的页面版本校验功能,故障重启页面版本信息会丢失。persistence表示开启持久态的页面版本校验功能,故障重启页面版本信息不丢失。

cn:audit_thread_num

审计线程的个数,取值范围 1~48。

recovery_time_target

在流式容灾模式下设置hadr_recovery_time_target能够让备数据库实例完成日志写入和回放。设置时间过小会影响主机的性能,设置过大会失去流控效果,0是指不开启日志流控。单位为秒。

dn:enable_convert_illegal_char

控制数据库是否支持超出字符集范围的字符。

dn:system_view_version

控制系统视图的版本。所有版本向下兼容,例如system_view_version=3时同时满足版本2与版本1的所有特性。详细内容请参考产品文档。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:codegen_compile_thread_num

该参数用于设置Codegen编译线程的线程数量。

dn:resilience_ctrlstmt_detect_timelimit

正常SQL语句被标记为慢SQL的执行时间,0不做慢SQL识别,大于0表示执行的SQL执行时间超过该时间后备标记为慢SQL。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。单位为毫秒。

cn:a_format_date_timestamp

控制current_date、current_timestamp、localtimestamp在事务开启时返回系统时间,替代原有的事务开启时间。

cn:recovery_max_workers

并行回放线程个数。

dn:max_compile_functions

设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

cn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。0表示关闭,1表示开启。

dn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为毫秒。

cn:num_internal_lock_partitions

控制内部轻量级锁分区的个数。该参数的调整会对性能与内存占用产生一定程度的影响,请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

dn:recovery_parse_workers

极致RTO特性中ParseRedoRecord线程的数量。1.需要配合recovery_redo_workers使用。recovery_parse_workers和recovery_redo_workers同时大于1,则开启极致RTO。如不期望开启极致RTO,请保持recovery_parse_workers为默认值1;2.在开启极致RTO时确保参数replication_type为1;3.若同时开启极致RTO和并行回放,则极致RTO特性生效,并行回放特性失效;4.极致RTO不支持列存,在已经使用列存表或者即将使用列存表的系统中,请关闭极致RTO;5.极致RTO不支持流控,流控统一由recovery_time_target参数控制。

dn:enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

cn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

dn:page_version_check

启用页面版本校验功能类型。off表示关闭页面版本校验功能。memory表示开启纯内存态的页面版本校验功能,故障重启页面版本信息会丢失。persistence表示开启持久态的页面版本校验功能,故障重启页面版本信息不丢失。

cn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

cn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为毫秒。

dn:num_internal_lock_partitions

控制内部轻量级锁分区的个数。该参数的调整会对性能与内存占用产生一定程度的影响,请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

cn:page_version_max_num

内存中所能缓存的页面版本信息的最大数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

dn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。0表示关闭,1表示开启。

cn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:auto_increment_cache

对自动增长列批量插入或导入触发自增时,预留自增缓存值的个数。预留自增值时刷新自增计数器为自增缓存值的最大值,缓存值使用完毕之前,自增计数器值不变,触发自增使用缓存的值。参数值为0时,自动预留自增缓存值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留2^n个值,例如,第一次自增预留1个值,第二次自增预留2个值,第三次预留4个值,第四次预留8个值,以此类推,若预留值个数超过65535,预留65535个值。参数值不为0时,预留缓存值的数量为参数值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留auto_increment_cache数量的自增值。预留的缓存值仅在语句内生效,若预留的自增缓存值没有全部被使用,后续插入语句基于自增计数器触发自增,会出现表中自动增长列的值不连续的情况。此参数不影响本地临时表中的自动增长列。

dn:enable_codegen

标识是否允许开启代码生成优化,目前代码生成使用的是LLVM优化。

dn:instr_unique_sql_combination_options

Unique SQL 同类语句归并功能配置项。开启该特性会将同类语句的Unique SQL ID归一,并将生成的Unique SQL String做归一化处理。

dn:behavior_compat_options

数据库兼容性行为配置项。proc_outparam_override选项行为变更后,业务需要重新建立连接或者重新启动集群,否则无法正确调用存储过程和函数。

dn:enable_early_free

控制是否可以实现算子内存的提前释放。

dn:page_missing_dirty_check

页面漏置脏校验的功能开关,检测被修改页面是否忘记置脏,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

cn:undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。单位为秒。

dn:wdr_snapshot_full_backup_interval

WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式。单位为百分比。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:wdr_snapshot_space_threshold

快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的80%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。单位为KB。

cn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

dn:hll_duplicate_check

该参数可以用来指定是否默认开启duplicatecheck。

cn:gs_perf_interval

设置自动采集perf采集间隔,(0表示停止采集,当参数修改为大于0小于5时会设置成值5)。单位为分钟。

cn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:gs_perf_interval

设置自动采集perf采集间隔,(0表示停止采集,当参数修改为大于0小于5时会设置成值5)。单位为分钟。

dn:extra_float_digits

这个参数为浮点数值调整显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。设置为负数,表示消除不需要的数据位。

cn:disable_keyword_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。设置该参数的标识符将不会作为关键字使用。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

cn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

track_stmt_stat_level

控制语句执行跟踪的级别。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

cn:b_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

dn:copy_special_character_version

COPY FROM导入导出数据时是否对非法编码的字符进行校验报错。

cn:page_version_recycler_thread_num

控制回收和校验页面版本信息的线程数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

enable_wdr_snapshot

是否开启WDR 性能快照,开启时内核将定期进行性能视图快照。

dn:effective_cache_size

设置DN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。单位为8KB。

cn:wdr_snapshot_full_backup_interval

WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。

cn:extra_float_digits

这个参数为浮点数值调整显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。设置为负数,表示消除不需要的数据位。

cn:system_view_version

控制系统视图的版本。所有版本向下兼容,例如system_view_version=3时同时满足版本2与版本1的所有特性。详细内容请参考产品文档。

cn:recyclebin_retention_time

单位为秒。设置回收站对象保留时间,超过该时间的回收站对象将被自动清理。

cn:password_encryption_type

设置用户密码的加密方式。0表示采用md5方式对密码加密。1表示采用sha256和md5两种方式分别对密码加密,2表示采用sha256方式对密码加密,3表示采用sm3方式对密码加密。MD5加密算法安全性低,存在安全风险,不建议使用。

cn:check_disconnect_query

控制客户端超时断连后,服务端语句终止执行功能是否开启。

password_effect_time

该字段决定账户密码的有效时间。单位为天。

cn:verify_log_buffers

控制内存态verify log buffers大小,代表页数,单位为8KB。例如:数值为4时,代表申请内存为4 * 8KB = 32kB。仅在page_version_check为persistence下生效。page_version_check为非persistence时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为persistence时才会真正生效。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

cn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

cn:enable_rls_match_index

控制是否支持在行级访问控制特性使用场景中,基于目标谓词条件对基表执行索引扫描。目标场景为:基表设置并开启了RLS(Row Level Security)策略,查询谓词中包含unleakproof类型系统函数或like操作符。

dn:crypto_module_info

高危参数,设置错误会导致集群重启时校验失败。请在充分测试验证后谨慎操作!透明加密使用third_kms的前置条件。用于打开第三方加密库以及配置使用第三方加密库时的参数配置。详细设置方法请参考产品文档该参数的相关章节。

dn:enable_analyze_check

标识是否允许在生成计划的时候,对于在pg_class中显示reltuples和relpages均为0的表,检查该表是否曾进行过统计信息收集。

cn:resilience_ctrlstmt_control_iopslimit

正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 0(None):表示不对IOPS做限制。 10(LOW):表示对IOPS限制等级为LOW。 20(MEDIUM):表示对IOPS限制等级为MEDIUM。 50(HIGH):表示对IOPS限制等级为HIGH。

dn:auto_increment_increment

自动增长列的自增步长,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若小于auto_increment_offset自动增长列自增时会产生错误。

cn:copy_special_character_version

COPY FROM导入导出数据时是否对非法编码的字符进行校验报错。

cn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

dn:gs_format_behavior_compat_options

gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。

cn:hll_duplicate_check

该参数可以用来指定是否默认开启duplicatecheck。

cn:max_standby_streaming_delay

当开启双机热备模式时,如果备机正通过流复制接收WAL日志数据,此时进行查询会产生冲突,此参数设置备机取消查询之前等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

dn:b_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

dn:check_disconnect_query

控制客户端超时断连后,服务端语句终止执行功能是否开启。

cn:gs_format_behavior_compat_options

gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。

cn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数。单位为天。

cn:static_thread_pool_num

线程个数,表示用于创建静态线程池(静态池)的线程个数。该参数仅在enable_thread_pool打开后分布式CN上生效。

dn:max_standby_streaming_delay

当开启双机热备模式时,如果备机正通过流复制接收WAL日志数据,此时进行查询会产生冲突,此参数设置备机取消查询之前等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

audit_system_object

该参数决定是否对GaussDB数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计。详细取值范围需参考产品文档。

cn:enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

cn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

dn:page_version_partitions

内存中缓存页面版本信息的哈希表分区数量,分区数量直接影响哈希查询效率和哈希冲突概率, 仅在page_version_check为非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:page_version_recycler_thread_num

控制回收和校验页面版本信息的线程数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:password_encryption_type

设置用户密码的加密方式。0表示采用md5方式对密码加密。1表示采用sha256和md5两种方式分别对密码加密,2表示采用sha256方式对密码加密,3表示采用sm3方式对密码加密。MD5加密算法安全性低,存在安全风险,不建议使用。

dn:dcf_thread_effective_time

DCF刷盘线程存活有效时间。参数用于判断磁盘是否处于I/O hang,超过此时间DCF无法访问I/O资源则认为线程I/O hang,则会触发降备动作。参数配置为0表示关闭I/O hang检测。单位为秒。

dn:a_format_date_timestamp

控制current_date、current_timestamp、localtimestamp在事务开启时返回系统时间,替代原有的事务开启时间。

cn:crypto_module_info

高危参数,设置错误会导致集群重启时校验失败。请在充分测试验证后谨慎操作!透明加密使用third_kms的前置条件。用于打开第三方加密库以及配置使用第三方加密库时的参数配置。详细设置方法请参考产品文档该参数的相关章节。

dn:hll_default_log2sparse

该参数可以用来设置从Sparse模式到Full模式的默认阈值大小。

cn:enable_xid_abort_check

事务提交时校验事务ID回滚开关是否开启。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置。单位为秒。

cn:hll_default_log2sparse

该参数可以用来设置从Sparse模式到Full模式的默认阈值大小。

dn:disable_keyword_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。设置该参数的标识符将不会作为关键字使用。

cn:fix_func_selection

是否优化函数匹配策略。选项值catlist: 优化catlist顺序问题;(对非B兼容模式进行优化,非B兼容模式下始终优先选择系统函数并执行。B兼容模式与505.1.0版本之前的版本保持一致,可能提示函数不唯一的错误,也可能选中系统函数进行执行)

cn:support_binary_copy_version

COPY FROM的BINARY模式下导入数据时是否进行二进制文件编码信息校验。无特殊情况时建议配置为默认取值,仅做前向兼容时需另行配置为空。

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

password_lock_time

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔。单位为分钟。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错。单位为毫秒。

dn:undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。单位为秒。

cn:recovery_parse_workers

极致RTO特性中ParseRedoRecord线程的数量。1.需要配合recovery_redo_workers使用。recovery_parse_workers和recovery_redo_workers同时大于1,则开启极致RTO。如不期望开启极致RTO,请保持recovery_parse_workers为默认值1;2.在开启极致RTO时确保参数replication_type为1;3.若同时开启极致RTO和并行回放,则极致RTO特性生效,并行回放特性失效;4.极致RTO不支持列存,在已经使用列存表或者即将使用列存表的系统中,请关闭极致RTO;5.极致RTO不支持流控,流控统一由recovery_time_target参数控制。

cn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,建议不小于undo_limit_size_per_transaction的值。单位为8KB。

cn:auto_increment_cache

对自动增长列批量插入或导入触发自增时,预留自增缓存值的个数。预留自增值时刷新自增计数器为自增缓存值的最大值,缓存值使用完毕之前,自增计数器值不变,触发自增使用缓存的值。参数值为0时,自动预留自增缓存值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留2^n个值,例如,第一次自增预留1个值,第二次自增预留2个值,第三次预留4个值,第四次预留8个值,以此类推,若预留值个数超过65535,预留65535个值。参数值不为0时,预留缓存值的数量为参数值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留auto_increment_cache数量的自增值。预留的缓存值仅在语句内生效,若预留的自增缓存值没有全部被使用,后续插入语句基于自增计数器触发自增,会出现表中自动增长列的值不连续的情况。此参数不影响本地临时表中的自动增长列。

dn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

cn:enable_early_free

控制是否可以实现算子内存的提前释放。

cn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。理论最大值为10000。根据实际业务需要和硬件配置设置此参数,建议不超过max_connections的1/10。

cn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

cn:enable_enhance_toast_table

enable_enhance_toast_table=on表示使用Enhanced Toast线外存储表。enable_enhance_toast_table=off表示使用Toast线外存储表。

cn:archive_interval

表示归档间隔时间。超过该参数设定的时间时强制归档日志文件。设置较大影响PITR的RPO,建议使用默认值。单位为秒。

dn:undo_limit_size_per_transaction

用于控制单事务undo分配空间阈值,达到阈值时事务报错回滚,建议undo_limit_size_per_transaction的值小于undo_space_limit_size的值,若大于undo_space_limit_size的值,可以设置成功,但是在使用时取两个参数的最小值作为实际的单事务undo分配空间阈值。如果设置 undo_limit_size_per_transaction 超过 1TB,可能会影响系统的性能和稳定性。单位为8KB。

dn:convert_illegal_char_mode

用于在enable_convert_illegal_char参数开启时,设置客户端显示非法编码的占位符。取值范围为ascii编码表中十进制编码为32至126的95个可显示字符。

cn:enable_analyze_check

标识是否允许在生成计划的时候,对于在pg_class中显示reltuples和relpages均为0的表,检查该表是否曾进行过统计信息收集。

dn:tde_index_default_encrypt

如果tde_index_default_encrypt=on,创建索引时,如果基表是加密表,则自动将新索引转换为加密索引。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

dn:enable_bbox_dump

是否开启黑匣子功能,在系统不配置core机制的时候仍可产生core文件。

dn:enable_recyclebin

用来控制回收站的实时打开和关闭。

cn:wdr_snapshot_space_threshold

快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的80%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。单位为KB。

enable_global_syscache

控制是否使用全局系统缓存。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

cn:max_compile_functions

设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

dn:auto_increment_offset

自动增长列的起始值,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若大于auto_increment_increment自动增长列自增时会产生错误。

cn:track_stmt_session_slot

设置一个session缓存的最大的全量/慢SQL的数量,超过这个数量,新的语句执行将不会被跟踪,直到落盘线程将缓存语句落盘,留出空闲的空间。推荐设置为默认值。

cn:page_version_partitions

内存中缓存页面版本信息的哈希表分区数量,分区数量直接影响哈希查询效率和哈希冲突概率, 仅在page_version_check为非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时。单位为秒。

dn:index_txntype

设置索引页面格式为PCR或RCR。该值在系统初始化时为空,创建的索引默认兼容老版本索引类型(RCR类型);一旦手动设置该参数后无法再设置为空。

cn:enable_recyclebin

用来控制回收站的实时打开和关闭。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能。单位为毫秒。

max_replication_slots

设置主机端的日志复制slot个数。

cn:enable_bbox_dump

是否开启黑匣子功能,在系统不配置core机制的时候仍可产生core文件。

datestyle

设置日期和时间值的显示格式。

dn:hll_default_log2m

该参数可以指定hll数据结构桶的个数。

enable_slot_log

是否开启逻辑复制槽主备同步特性。目前仅涉及归档槽及备份槽。云场景且开启逻辑复制功能时设置为on,其他场景设置为off。

cn:enable_convert_illegal_char

控制数据库是否支持超出字符集范围的字符。

cn:enable_workload_rule

控制系统是否启用SQL限流。

cn:index_txntype

设置索引页面格式为PCR或RCR。该值在系统初始化时为空,创建的索引默认兼容老版本索引类型(RCR类型);一旦手动设置该参数后无法再设置为空。

dn:enable_enhance_toast_table

enable_enhance_toast_table=on表示使用Enhanced Toast线外存储表。enable_enhance_toast_table=off表示使用Toast线外存储表。

dn:support_binary_copy_version

COPY FROM的BINARY模式下导入数据时是否进行二进制文件编码信息校验。无特殊情况时建议配置为默认取值,仅做前向兼容时需另行配置为空。

enable_stream_operator

控制优化器对stream的使用。当enable_stream_operator参数关闭时,会有大量关于计划不能下推的日志记录到日志文件中。如果不需要这些日志内容,建议在enable_stream_operator参数关闭时,也同时关闭enable_unshipping_log参数。推荐使用默认值。

cn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

cn:gs_perf_retention_days

设置火焰图html文件保留天数。单位为天。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

dn:enable_rls_match_index

控制是否支持在行级访问控制特性使用场景中,基于目标谓词条件对基表执行索引扫描。目标场景为:基表设置并开启了RLS(Row Level Security)策略,查询谓词中包含unleakproof类型系统函数或like操作符。

dn:audit_internal_event

该参数决定是否审计内部工具cm_agent、gs_clean、WDRXdb的连接及进行的操作、DN上是否对来自CN的登入登出进行审计。

cn:effective_cache_size

设置CN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。单位为8KB。

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

dn:hll_default_log2explicit

该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。

cn:instr_unique_sql_combination_options

Unique SQL 同类语句归并功能配置项。

dn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,建议不小于undo_limit_size_per_transaction的值。单位为8KB。

dn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

dn:llvm_max_memory

此参数仅限制Codegen执行方式下,编译产生的IR(包括缓存的和正在使用的)内存使用上限。Codegen使用的内存不采用预占的方式申请,属于max_dynamic_memory的一部分,且受llvm_max_memory参数的限制。单位为KB。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

cn:tde_index_default_encrypt

如果tde_index_default_encrypt=on,创建索引时,如果基表是加密表,则自动将新索引转换为加密索引。

dn:enable_workload_rule

控制系统是否启用SQL限流。

dn:archive_interval

表示归档间隔时间。超过该参数设定的时间时强制归档日志文件。设置较大影响PITR的RPO,建议使用默认值。单位为秒。

cn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

cn:enable_codegen

标识是否允许开启代码生成优化,目前代码生成使用的是LLVM优化。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。该参数值设置小于20可能会导致扩容失败。该参数值需要小于max_connections参数的值。

cn:undo_limit_size_per_transaction

用于控制单事务undo分配空间阈值,达到阈值时事务报错回滚,建议undo_limit_size_per_transaction的值小于undo_space_limit_size的值,若大于undo_space_limit_size的值,可以设置成功,但是在使用时取两个参数的最小值作为实际的单事务undo分配空间阈值。如果设置 undo_limit_size_per_transaction 超过 1TB,可能会影响系统的性能和稳定性。单位为8KB。

dn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。理论最大值为10000。根据实际业务需要和硬件配置设置此参数,建议不超过max_connections的1/10。

cn:page_missing_dirty_check

页面漏置脏校验的功能开关,检测被修改页面是否忘记置脏,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

cn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

cn:audit_dml_state_select

是否对SELECT操作进行审计。

cn:hll_default_log2m

该参数可以指定hll数据结构桶的个数。

表2 分布式混合部署参数

参数名称

描述

recyclebin_retention_time

设置回收站对象保留时间,超过该时间的回收站对象将被自动清理。单位为秒。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时。单位为秒。

cn:page_version_partitions

内存中缓存页面版本信息的哈希表分区数量,分区数量直接影响哈希查询效率和哈希冲突概率, 仅在page_version_check为非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:index_txntype

设置索引页面格式为PCR或RCR。该值在系统初始化时为空,创建的索引默认兼容老版本索引类型(RCR类型);一旦手动设置该参数后无法再设置为空。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能。单位为毫秒。

datestyle

设置日期和时间值的显示格式。

max_replication_slots

设置主机端的日志复制slot个数。

timezone

设置显示和解释时间类型数值时使用的时区。

cn:auto_increment_offset

自动增长列的起始值,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若大于auto_increment_increment自动增长列自增时会产生错误。

dn:enable_xid_abort_check

事务提交时校验事务ID回滚开关是否开启。

cn:audit_internal_event

该参数决定是否审计内部工具cm_agent、gs_clean、WDRXdb的连接及进行的操作、DN上是否对来自CN的登入登出进行审计。

enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

enable_slot_log

是否开启逻辑复制槽主备同步特性。目前仅涉及归档槽及备份槽。云场景且开启逻辑复制功能时设置为on,其他场景设置为off。

cn:enable_convert_illegal_char

控制数据库是否支持超出字符集范围的字符。

cn:codegen_compile_thread_num

该参数用于设置Codegen编译线程的线程数量。

cn:enable_workload_rule

控制系统是否启用SQL限流。

dn:enable_enhance_toast_table

enable_enhance_toast_table=on表示使用Enhanced Toast线外存储表。enable_enhance_toast_table=off表示使用Toast线外存储表。

dn:static_thread_pool_num

线程个数,表示用于创建静态线程池(静态池)的线程个数。该参数仅在enable_thread_pool打开后分布式CN上生效。

enable_stream_operator

控制优化器对stream的使用。当enable_stream_operator参数关闭时,会有大量关于计划不能下推的日志记录到日志文件中。如果不需要这些日志内容,建议在enable_stream_operator参数关闭时,也同时关闭enable_unshipping_log参数。推荐使用默认值。

cn:auto_increment_increment

自动增长列的自增步长,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若小于auto_increment_offset自动增长列自增时会产生错误。

dn:support_binary_copy_version

COPY FROM的BINARY模式下导入数据时是否进行二进制文件编码信息校验。无特殊情况时建议配置为默认取值,仅做前向兼容时需另行配置为空。

cn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

cn:gs_perf_retention_days

设置火焰图html文件保留天数。单位为天。

dn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

cn:sql_mode

M-Compatibility模式下SQL行为控制配置项。

dn:enable_rls_match_index

控制是否支持在行级访问控制特性使用场景中,基于目标谓词条件对基表执行索引扫描。目标场景为:基表设置并开启了RLS(Row Level Security)策略,查询谓词中包含unleakproof类型系统函数或like操作符。

dn:audit_internal_event

该参数决定是否审计内部工具cm_agent、gs_clean、WDRXdb的连接及进行的操作、DN上是否对来自CN的登入登出进行审计。

cn:llvm_max_memory

此参数仅限制Codegen执行方式下,编译产生的IR(包括缓存的和正在使用的)内存使用上限。Codegen使用的内存不采用预占的方式申请,属于max_dynamic_memory的一部分,且受llvm_max_memory参数的限制。单位为KB。

dn:fix_func_selection

是否优化函数匹配策略。选项值catlist: 优化catlist顺序问题;(对非B兼容模式进行优化,非B兼容模式下始终优先选择系统函数并执行。B兼容模式与505.1.0版本之前的版本保持一致,可能提示函数不唯一的错误,也可能选中系统函数进行执行)

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

comm_no_delay

是否使用通信库连接时的no_delay属性。

enable_recyclebin

用来控制回收站的实时打开和关闭。

dn:sql_mode

M-Compatibility模式下SQL行为控制配置项。

cn:instr_unique_sql_combination_options

Unique SQL 同类语句归并功能配置项。

dn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

dn:verify_log_buffers

控制内存态verify log buffers大小,代表页数,单位为8kB。例如:数值为4时,代表申请内存为4 * 8kB = 32kB。仅在page_version_check为persistence下生效。page_version_check为非persistence时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为persistence时才会真正生效。

cn:convert_illegal_char_mode

用于在enable_convert_illegal_char参数开启时,设置客户端显示非法编码的占位符。取值范围为ascii编码表中十进制编码为32至126的95个可显示字符。

dn:llvm_max_memory

此参数仅限制Codegen执行方式下,编译产生的IR(包括缓存的和正在使用的)内存使用上限。Codegen使用的内存不采用预占的方式申请,属于max_dynamic_memory的一部分,且受llvm_max_memory参数的限制。单位为KB。

cn:page_version_check

启用页面版本校验功能类型。off表示关闭页面版本校验功能。memory表示开启纯内存态的页面版本校验功能,故障重启页面版本信息会丢失。persistence表示开启持久态的页面版本校验功能,故障重启页面版本信息不丢失。

undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,建议不小于undo_limit_size_per_transaction的值。单位为8KB。

cn:tde_index_default_encrypt

如果tde_index_default_encrypt=on,创建索引时,如果基表是加密表,则自动将新索引转换为加密索引。

recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

dn:enable_convert_illegal_char

控制数据库是否支持超出字符集范围的字符。

dn:system_view_version

控制系统视图的版本。所有版本向下兼容,例如system_view_version=3时同时满足版本2与版本1的所有特性。详细内容请参考产品文档。

dn:enable_workload_rule

控制系统是否启用SQL限流。

dn:archive_interval

表示归档间隔时间。超过该参数设定的时间时强制归档日志文件。设置较大影响PITR的RPO,建议使用默认值。单位为秒。

cn:enable_codegen

标识是否允许开启代码生成优化,目前代码生成使用的是LLVM优化。

dn:codegen_compile_thread_num

该参数用于设置Codegen编译线程的线程数量。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。该参数值设置小于20可能会导致扩容失败。该参数值需要小于max_connections参数的值。

dn:resilience_ctrlstmt_detect_timelimit

正常SQL语句被标记为慢SQL的执行时间,0不做慢SQL识别,大于0表示执行的SQL执行时间超过该时间后备标记为慢SQL。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。单位为毫秒。

cn:a_format_date_timestamp

控制current_date、current_timestamp、localtimestamp在事务开启时返回系统时间,替代原有的事务开启时间。

cn:page_missing_dirty_check

页面漏置脏校验的功能开关,检测被修改页面是否忘记置脏,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

cn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

dn:max_compile_functions

设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

dn:tde_index_default_encrypt

如果tde_index_default_encrypt=on,创建索引时,如果基表是加密表,则自动将新索引转换为加密索引。

dn:recovery_parse_workers

极致RTO特性中ParseRedoRecord线程的数量。1.需要配合recovery_redo_workers使用。recovery_parse_workers和recovery_redo_workers同时大于1,则开启极致RTO。如不期望开启极致RTO,请保持recovery_parse_workers为默认值1;2.在开启极致RTO时确保参数replication_type为1;3.若同时开启极致RTO和并行回放,则极致RTO特性生效,并行回放特性失效;4.极致RTO不支持列存,在已经使用列存表或者即将使用列存表的系统中,请关闭极致RTO;5.极致RTO不支持流控,流控统一由recovery_time_target参数控制。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。单位为秒。

cn:wdr_snapshot_space_threshold

快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的80%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。单位为KB。

dn:page_version_check

启用页面版本校验功能类型。off表示关闭页面版本校验功能。memory表示开启纯内存态的页面版本校验功能,故障重启页面版本信息会丢失。persistence表示开启持久态的页面版本校验功能,故障重启页面版本信息不丢失。

cn:max_compile_functions

设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

cn:page_version_max_num

内存中所能缓存的页面版本信息的最大数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:auto_increment_offset

自动增长列的起始值,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若大于auto_increment_increment自动增长列自增时会产生错误。

dn:auto_increment_cache

对自动增长列批量插入或导入触发自增时,预留自增缓存值的个数。预留自增值时刷新自增计数器为自增缓存值的最大值,缓存值使用完毕之前,自增计数器值不变,触发自增使用缓存的值。参数值为0时,自动预留自增缓存值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留2^n个值,例如,第一次自增预留1个值,第二次自增预留2个值,第三次预留4个值,第四次预留8个值,以此类推,若预留值个数超过65535,预留65535个值。参数值不为0时,预留缓存值的数量为参数值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留auto_increment_cache数量的自增值。预留的缓存值仅在语句内生效,若预留的自增缓存值没有全部被使用,后续插入语句基于自增计数器触发自增,会出现表中自动增长列的值不连续的情况。此参数不影响本地临时表中的自动增长列。

dn:enable_codegen

标识是否允许开启代码生成优化,目前代码生成使用的是LLVM优化。

dn:instr_unique_sql_combination_options

Unique SQL 同类语句归并功能配置项。开启该特性会将同类语句的Unique SQL ID归一,并将生成的Unique SQL String做归一化处理。

rewrite_rule

查询重写规则。

dn:page_missing_dirty_check

页面漏置脏校验的功能开关,检测被修改页面是否忘记置脏,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:wdr_snapshot_full_backup_interval

WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。

dn:wdr_snapshot_space_threshold

快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的80%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。单位为KB。

cn:gs_perf_interval

设置自动采集perf采集间隔,(0表示停止采集,当参数修改为大于0小于5时会设置成值5)。单位为分钟。

dn:gs_perf_interval

设置自动采集perf采集间隔,(0表示停止采集,当参数修改为大于0小于5时会设置成值5)。单位为分钟。

dn:extra_float_digits

这个参数为浮点数值调整显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。设置为负数,表示消除不需要的数据位。

cn:disable_keyword_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。设置该参数的标识符将不会作为关键字使用。

track_stmt_stat_level

控制语句执行跟踪的级别。

cn:b_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

dn:copy_special_character_version

COPY FROM导入导出数据时是否对非法编码的字符进行校验报错。

cn:page_version_recycler_thread_num

控制回收和校验页面版本信息的线程数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

cn:wdr_snapshot_full_backup_interval

WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。

cn:extra_float_digits

这个参数为浮点数值调整显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。设置为负数,表示消除不需要的数据位。

cn:system_view_version

控制系统视图的版本。所有版本向下兼容,例如system_view_version=3时同时满足版本2与版本1的所有特性。详细内容请参考产品文档。

support_batch_bind

是否可以通过JDBC、ODBC、Libpq等接口进行批量绑定和执行PBE形式的语句。

cn:check_disconnect_query

控制客户端超时断连后,服务端语句终止执行功能是否开启。

password_effect_time

该字段决定账户密码的有效时间。单位为天。

cn:verify_log_buffers

控制内存态verify log buffers大小,代表页数,单位为8kB。例如:数值为4时,代表申请内存为4 * 8kB = 32kB。仅在page_version_check为persistence下生效。page_version_check为非persistence时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为persistence时才会真正生效。

cn:enable_slot_log

是否开启逻辑复制槽主备同步特性。目前仅涉及归档槽及备份槽。云场景且开启逻辑复制功能时设置为on,其他场景设置为off。

undo_limit_size_per_transaction

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,建议不小于undo_limit_size_per_transaction的值。单位为8KB。

dn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

cn:enable_rls_match_index

控制是否支持在行级访问控制特性使用场景中,基于目标谓词条件对基表执行索引扫描。目标场景为:基表设置并开启了RLS(Row Level Security)策略,查询谓词中包含unleakproof类型系统函数或like操作符。

dn:crypto_module_info

高危参数,设置错误会导致集群重启时校验失败。请在充分测试验证后谨慎操作!透明加密使用third_kms的前置条件。用于打开第三方加密库以及配置使用第三方加密库时的参数配置。详细设置方法请参考产品文档该参数的相关章节。

dn:auto_increment_increment

自动增长列的自增步长,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若小于auto_increment_offset自动增长列自增时会产生错误。

cn:copy_special_character_version

COPY FROM导入导出数据时是否对非法编码的字符进行校验报错。

behavior_compat_options

数据库兼容性行为配置项。proc_outparam_override选项行为变更后,业务需要重新建立连接或者重新启动集群,否则无法正确调用存储过程和函数。

dn:gs_format_behavior_compat_options

gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。

dn:b_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

dn:check_disconnect_query

控制客户端超时断连后,服务端语句终止执行功能是否开启。

cn:gs_format_behavior_compat_options

gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数。单位为天。

cn:static_thread_pool_num

线程个数,表示用于创建静态线程池(静态池)的线程个数。该参数仅在enable_thread_pool打开后分布式CN上生效。

audit_system_object

该参数决定是否对GaussDB数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计。详细取值范围需参考产品文档。

cn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

dn:enable_slot_log

是否开启逻辑复制槽主备同步特性。目前仅涉及归档槽及备份槽。云场景且开启逻辑复制功能时设置为on,其他场景设置为off。

dn:page_version_partitions

内存中缓存页面版本信息的哈希表分区数量,分区数量直接影响哈希查询效率和哈希冲突概率, 仅在page_version_check为非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:page_version_recycler_thread_num

控制回收和校验页面版本信息的线程数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:dcf_thread_effective_time

DCF刷盘线程存活有效时间。参数用于判断磁盘是否处于I/O hang,超过此时间DCF无法访问I/O资源则认为线程I/O hang,则会触发降备动作。参数配置为0表示关闭I/O hang检测。单位为秒。

dn:a_format_date_timestamp

控制current_date、current_timestamp、localtimestamp在事务开启时返回系统时间,替代原有的事务开启时间。

cn:crypto_module_info

高危参数,设置错误会导致集群重启时校验失败。请在充分测试验证后谨慎操作!透明加密使用third_kms的前置条件。用于打开第三方加密库以及配置使用第三方加密库时的参数配置。详细设置方法请参考产品文档该参数的相关章节。

cn:enable_xid_abort_check

事务提交时校验事务ID回滚开关是否开启。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置。单位为秒。

dn:disable_keyword_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。设置该参数的标识符将不会作为关键字使用。

cn:fix_func_selection

是否优化函数匹配策略。选项值catlist: 优化catlist顺序问题;(对非B兼容模式进行优化,非B兼容模式下始终优先选择系统函数并执行。B兼容模式与505.1.0版本之前的版本保持一致,可能提示函数不唯一的错误,也可能选中系统函数进行执行)

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

password_lock_time

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

cn:support_binary_copy_version

COPY FROM的BINARY模式下导入数据时是否进行二进制文件编码信息校验。无特殊情况时建议配置为默认取值,仅做前向兼容时需另行配置为空。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错。单位为毫秒。

cn:recovery_parse_workers

极致RTO特性中ParseRedoRecord线程的数量。1.需要配合recovery_redo_workers使用。recovery_parse_workers和recovery_redo_workers同时大于1,则开启极致RTO。如不期望开启极致RTO,请保持recovery_parse_workers为默认值1;2.在开启极致RTO时确保参数replication_type为1;3.若同时开启极致RTO和并行回放,则极致RTO特性生效,并行回放特性失效;4.极致RTO不支持列存,在已经使用列存表或者即将使用列存表的系统中,请关闭极致RTO;5.极致RTO不支持流控,流控统一由recovery_time_target参数控制。

cn:auto_increment_cache

对自动增长列批量插入或导入触发自增时,预留自增缓存值的个数。预留自增值时刷新自增计数器为自增缓存值的最大值,缓存值使用完毕之前,自增计数器值不变,触发自增使用缓存的值。参数值为0时,自动预留自增缓存值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留2^n个值,例如,第一次自增预留1个值,第二次自增预留2个值,第三次预留4个值,第四次预留8个值,以此类推,若预留值个数超过65535,预留65535个值。参数值不为0时,预留缓存值的数量为参数值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留auto_increment_cache数量的自增值。预留的缓存值仅在语句内生效,若预留的自增缓存值没有全部被使用,后续插入语句基于自增计数器触发自增,会出现表中自动增长列的值不连续的情况。此参数不影响本地临时表中的自动增长列。

cn:enable_enhance_toast_table

enable_enhance_toast_table=on表示使用Enhanced Toast线外存储表。enable_enhance_toast_table=off表示使用Toast线外存储表。

cn:archive_interval

表示归档间隔时间。超过该参数设定的时间时强制归档日志文件。设置较大影响PITR的RPO,建议使用默认值。单位为秒。

dn:convert_illegal_char_mode

用于在enable_convert_illegal_char参数开启时,设置客户端显示非法编码的占位符。取值范围为ascii编码表中十进制编码为32至126的95个可显示字符。

表3 主备版参数

参数名称

描述

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:recovery_max_workers

并行回放线程个数。

dn:enable_auto_clean_unique_sql

是否开启自动清理unique sql哈希表。

dn:gs_perf_retention_days

设置火焰图html文件保留天数。单位为天。

dn:page_version_max_num

内存中所能缓存的页面版本信息的最大数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

log_autovacuum_min_duration

设置自动清理时间阈值,当自动清理的执行时间大于或者等于某个特定的阈值,向服务器日志中记录自动清理执行的每一步操作。当参数设置为0时,表示所有的自动清理操作都记录到日志中。当参数设置为-1时,表示所有的自动清理操作都不记录到日志中。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能。单位为毫秒。

dn:max_connections

设置DN允许连接的最大并发连接数。该参数值需要大于max_wal_senders参数的值。

datestyle

设置日期和时间值的显示格式。

max_replication_slots

设置主机端的日志复制slot个数。

timezone

设置显示和解释时间类型数值时使用的时区。

dn:enable_xid_abort_check

事务提交时校验事务ID回滚开关是否开启。

enable_slot_log

是否开启逻辑复制槽主备同步特性。目前仅涉及归档槽及备份槽。云场景且开启逻辑复制功能时设置为on,其他场景设置为off。

dn:enable_enhance_toast_table

enable_enhance_toast_table=on表示使用Enhanced Toast线外存储表。enable_enhance_toast_table=off表示使用Toast线外存储表。

dn:plat_compat_allow_public_key_retrieval

M-Compatibility模式数据库行为配置项。该参数是用来控制是否允许客户端RSA Public key的开关。on表示内核允许客户端请求RSA Public key,支持口令通过RSA加密传输。off表示不允许客户端请求RSA Public key。

dn:support_binary_copy_version

COPY FROM的BINARY模式下导入数据时是否进行二进制文件编码信息校验。

dn:recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

plat_compat_allow_public_key_retrieval

M-Compatibility模式数据库行为配置项。该参数是用来控制是否允许客户端RSA Public key的开关。on表示内核允许客户端请求RSA Public key,支持口令通过RSA加密传输。off表示不允许客户端请求RSA Public key。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息

dn:enable_rls_match_index

控制是否支持在行级访问控制特性使用场景中,基于目标谓词条件对基表执行索引扫描。目标场景为:基表设置并开启了RLS(Row Level Security)策略,查询谓词中包含unleakproof类型系统函数或like操作符。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

dn:audit_internal_event

该参数决定是否审计内部工具cm_agent、gs_clean、WDRXdb的连接及进行的操作、DN上是否对来自CN的登入登出进行审计。

dn:numa_distribute_mode

用于控制部分共享数据和线程在NUMA节点间分布的属性。用于大型多NUMA节点的ARM服务器性能调优,一般不用设置。x86架构不支持设置为all。

dn:max_compile_packages

设置服务器存储的PACKAGE编译结果的最大数量。不同规格默认值:(max_process_memory * 2%)/ 4.4MB 向下取整。

dn:fix_func_selection

是否优化函数匹配策略。选项值catlist: 优化catlist顺序问题;(对非B兼容模式进行优化,非B兼容模式下始终优先选择系统函数并执行。B兼容模式与505.1.0版本之前的版本保持一致,可能提示函数不唯一的错误,也可能选中系统函数进行执行)

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

dn:sql_mode

M-Compatibility模式下SQL行为控制配置项。

dn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

dn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,建议不小于undo_limit_size_per_transaction的值。单位为8KB。

dn:umdk_enabled

控制当前数据库主备DN是否开启UMDK功能。若DN主备间通信走UMDK通信协议,则DN上相关日志关键字为“umdk”,若DN主备间通信走TCP协议,则记录log日志。

dn:verify_log_buffers

控制内存态verify log buffers大小,代表页数,单位为8kB。例如:数值为4时,代表申请内存为4 * 8kB = 32kB。仅在page_version_check为persistence下生效。page_version_check为非persistence时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为persistence时才会真正生效。

dn:llvm_max_memory

此参数仅限制Codegen执行方式下,编译产生的IR(包括缓存的和正在使用的)内存使用上限。Codegen使用的内存不采用预占的方式申请,属于max_dynamic_memory的一部分,且受llvm_max_memory参数的限制。单位为KB。

dn:enable_control_group

是否开启Cgroups功能。

dn:dcf_run_mode

DCF选举模式,0表示自动选举模式,2表示去使能选举模式。目前去使能选举模式只限定少数派恢复场景使用,修改会导致数据库实例不可用。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

dn:enable_convert_illegal_char

控制数据库是否支持超出字符集范围的字符。

dn:system_view_version

控制系统视图的版本。所有版本向下兼容,例如system_view_version=3时同时满足版本2与版本1的所有特性。详细内容请参考产品文档。

track_activity_query_size

指定记录每个SQL的最大字节数,超过此阈值,记录的SQL将被截断。该参数设置过大会占用大量内存,甚至把内存耗尽,建议不超过4096。

dn:enable_workload_rule

控制系统是否启用SQL限流。

dn:archive_interval

表示归档间隔时间。超过该参数设定的时间时强制归档日志文件。设置较大影响PITR的RPO,建议使用默认值。单位为秒。

div_precision_increment

M-Compatibility模式数据库行为配置项。会话级参数,用于设置除法结果精度提升值,也即结果精度为第一个操作参数的精度加上这个参数值。

lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错。单位为毫秒。

dn:adaptive_cost_min_time

该参数用于设置基数反馈收集的SQL时间阈值,只有执行时间大于该值的语句反馈会被收集。单位为毫秒。

cms:dn_arbitrate_mode

DN仲裁模式。DCF模式下,cm_ctl设置的DCF工作模式需要和GUC参数dcf_run_mode设置保持一致,即两者需要同步设置为DCF手动或自动模式。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:codegen_compile_thread_num

该参数用于设置Codegen编译线程的线程数量。

dn:enable_vectordb

表示是否允许创建向量索引,是否允许对向量索引增改查。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。该参数值设置小于20可能会导致扩容失败。该参数值需要小于max_connections参数的值。

dn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。理论最大值为10000。根据实际业务需要和硬件配置设置此参数,建议不超过max_connections的1/10。

dn:enable_extension

控制是否支持创建数据库扩展插件。请在特定场景经评估后使用,通常不需要调整。

dn:max_compile_functions

设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值,有助于减少内存占用,提升系统性能。请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

dn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为毫秒。

dn:enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

dn:enable_vacuum_control

是否控制数据库常驻线程autoVacuumWorker到Vacuum控制组。

dn:recovery_parse_workers

极致RTO特性中ParseRedoRecord线程的数量。1.需要配合recovery_redo_workers使用。recovery_parse_workers和recovery_redo_workers同时大于1,则开启极致RTO。如不期望开启极致RTO,请保持recovery_parse_workers为默认值1;2.在开启极致RTO时确保参数replication_type为1;3.若同时开启极致RTO和并行回放,则极致RTO特性生效,并行回放特性失效;4.极致RTO不支持列存,在已经使用列存表或者即将使用列存表的系统中,请关闭极致RTO;5.极致RTO不支持流控,流控统一由recovery_time_target参数控制。

dn:page_version_check

启用页面版本校验功能类型。off表示关闭页面版本校验功能。memory表示开启纯内存态的页面版本校验功能,故障重启页面版本信息会丢失。persistence表示开启持久态的页面版本校验功能,故障重启页面版本信息不丢失。

dn:track_activity_query_size

指定记录每个SQL的最大字节数,超过此阈值,记录的SQL将被截断。该参数设置过大会占用大量内存,甚至把内存耗尽,建议不超过4096。

dn:gsivfflat_secondary_probes

表示待搜索的二级倒排表的数量,超过二级倒排表总数时执行全表搜索。

dn:num_internal_lock_partitions

控制内部轻量级锁分区的个数。该参数的调整会对性能与内存占用产生一定程度的影响,请详细阅读参考资料,在明确适用场景并经测试充分验证后进行修改。

dn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

dn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。0表示关闭,1表示开启。

dn:auto_increment_cache

对自动增长列批量插入或导入触发自增时,预留自增缓存值的个数。预留自增值时刷新自增计数器为自增缓存值的最大值,缓存值使用完毕之前,自增计数器值不变,触发自增使用缓存的值。参数值为0时,自动预留自增缓存值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留2^n个值,例如,第一次自增预留1个值,第二次自增预留2个值,第三次预留4个值,第四次预留8个值,以此类推,若预留值个数超过65535,预留65535个值。参数值不为0时,预留缓存值的数量为参数值。第一次触发自增时,若已知即将插入自动增长列的行数,预留已知数量的值。若行数未知,每次预留auto_increment_cache数量的自增值。预留的缓存值仅在语句内生效,若预留的自增缓存值没有全部被使用,后续插入语句基于自增计数器触发自增,会出现表中自动增长列的值不连续的情况。此参数不影响本地临时表中的自动增长列。

dn:enable_codegen

标识是否允许开启代码生成优化,目前代码生成使用的是LLVM优化。

dn:instr_unique_sql_combination_options

Unique SQL 同类语句归并功能配置项。开启该特性会将同类语句的Unique SQL ID归一,并将生成的Unique SQL String做归一化处理。

plan_cache_mode

指定在prepare语句中执行计划的策略。

dn:group_concat_max_len

函数GROUP_CONCAT()结果的最大长度。

dn:hadr_recovery_point_target

在流式容灾模式下备机能够在hadr_recovery_point_target时间内完成日志的刷盘,可以保证主实例与备实例切换时日志差距能够在hadr_recovery_point_target秒内,保障备实例升主日志量。设置时间过小会影响主机的性能,设置过大会失去流控效果。0是指不开启日志流控。单位为秒。

dn:behavior_compat_options

数据库兼容性行为配置项。proc_outparam_override选项行为变更后,业务需要重新建立连接或者重新启动集群,否则无法正确调用存储过程和函数。

dn:page_missing_dirty_check

页面漏置脏校验的功能开关,检测被修改页面是否忘记置脏,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

dn:wdr_snapshot_full_backup_interval

WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔,而是间隔个数。例如,当取值为12时,每一组先生成一个全量快照,再生成11个增量快照;当取值为1时,每个快照都是全量快照。

dn:vacuum_defer_cleanup_age

指定VACUUM使用的事务数。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式。单位为百分比。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:wdr_snapshot_space_threshold

快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的80%时,会启用数据库的控制逻辑,使快照占用空间趋于平稳。单位为KB。

dn:m_format_behavior_compat_options

数据库M模式兼容性行为配置项。

dn:gs_perf_interval

设置自动采集perf采集间隔,(0表示停止采集,当参数修改为大于0小于5时会设置成值5)。单位为分钟。

dn:extra_float_digits

这个参数为浮点数值调整显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。设置为负数,表示消除不需要的数据位。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

max_allowed_packet

M-Compatibility模式数据库行为配置项。用于表示字符串函数返回值上限。必须是1024的整数倍。单位为KB。

track_stmt_stat_level

控制语句执行跟踪的级别。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

dn:copy_special_character_version

COPY FROM导入导出数据时是否对非法编码的字符进行校验报错。

log_temp_files

是否记录临时文件的删除信息。正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。值0表示记录所有的临时文件的删除信息。值-1表示不记录任何临时文件的删除信息。单位为KB。

enable_wdr_snapshot

是否开启备机支持数据库监控快照功能。

dn:m_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

password_effect_time

该字段决定账户密码的有效时间。单位为天。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:immediate_analyze_threshold

插入数据后自动做analyze的阈值。当新增数据量达到原有数据量的immediate_analyze_threshold倍,且总行数超过一百时,会自动触发一次analyze。

dn:crypto_module_info

高危参数,设置错误会导致集群重启时校验失败。请在充分测试验证后谨慎操作!透明加密使用third_kms的前置条件。用于打开第三方加密库以及配置使用第三方加密库时的参数配置。详细设置方法请参考产品文档该参数的相关章节。

dn:auto_increment_increment

自动增长列的自增步长,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若小于auto_increment_offset自动增长列自增时会产生错误。

dn:gs_format_behavior_compat_options

gs_format_behavior_compat_options用于选择GaussDB内部系统函数配置项。

enable_nestloop

控制优化器是否支持内表全表扫描嵌套循环连接规划类型。

dn:b_format_dev_version

数据库平台迭代小版本兼容性行为配置项。

dn:check_disconnect_query

控制客户端超时断连后,服务端语句终止执行功能是否开启。

dn:wal_keep_segments

“pg_xlog”目录下保留事务日志文件的最小数目。备机通过获取主机此处的日志进行流复制。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数。单位为天。

dn:max_standby_streaming_delay

当开启双机热备模式时,如果备机正通过流复制接收WAL日志数据,此时进行查询会产生冲突,此参数设置备机取消查询之前等待的时间。-1表示允许备机一直等待冲突的查询完成。单位为毫秒。

audit_system_object

该参数决定是否对GaussDB数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计。详细取值范围需参考产品文档。

dn:enable_copy_server_files

是否开启copy服务器端文件的权限。on表示开启copy服务端文件的权限,允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行COPY FROM FILENAME或COPY TO FILENAME命令。off表示不开启copy服务端文件的权限,只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令。

checkpoint_segments

设置checkpoint_timeout周期内所保留的最少WAL日志段文件数量。

dn:page_version_partitions

内存中缓存页面版本信息的哈希表分区数量,分区数量直接影响哈希查询效率和哈希冲突概率, 仅在page_version_check为非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。详细取值范围需参考产品文档。

dn:password_encryption_type

设置用户密码的加密方式。0表示采用md5方式对密码加密。1表示采用sha256和md5两种方式分别对密码加密,2表示采用sha256方式对密码加密,3表示采用sm3方式对密码加密。MD5加密算法安全性低,存在安全风险,不建议使用。

dn:enable_plsql_opfusion

控制是否开启存储过程支持SQLBypass功能。

dn:page_version_recycler_thread_num

控制回收和校验页面版本信息的线程数量,仅在page_version_check非off情况下生效。page_version_check为off时,修改的值会下发到内核,但实际功能不会生效,直到将page_version_check修改为非off时才会真正生效。

dn:dcf_thread_effective_time

DCF刷盘线程存活有效时间。参数用于判断磁盘是否处于I/O hang,超过此时间DCF无法访问I/O资源则认为线程I/O hang,则会触发降备动作。参数配置为0表示关闭I/O hang检测。单位为秒。

dn:audit_login_logout

这个参数决定是否审计用户的登录(包括登录成功和登录失败)、注销。该参数可在PDB级别设置。在PDB场景内,若未设置该参数,则继承来自全局的设置。0表示关闭用户登录、注销审计功能。1表示只审计用户登录成功。2表示只审计用户登录失败。3表示只审计用户登录成功和失败。4表示只审计用户注销。5表示只审计用户注销和登录成功。6表示只审计用户注销和登录失败。7表示审计用户登录成功、失败和注销。

dn:a_format_date_timestamp

控制current_date、current_timestamp、localtimestamp在事务开启时返回系统时间,替代原有的事务开启时间。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置。单位为秒。

temp_file_limit

设置在一个会话中,触发临时文件写盘操作时,单个写盘文件的空间大小。-1表示没有限制。单位为KB。

dn:disable_keyword_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。设置该参数的标识符将不会作为关键字使用。

dn:hadr_recovery_time_target

在流式容灾模式下设置hadr_recovery_time_target能够让备数据库实例完成日志写入和回放。设置时间过小会影响主机的性能,设置过大会失去流控效果,0是指不开启日志流控。单位为秒。

password_lock_time

设置账户被锁定后的自动解锁时间。单位为天。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔。单位为分钟。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错。单位为毫秒。

dn:wal_file_preinit_bounds

设置业务运行时,WAL writer辅助线程每秒可预扩的WAL日志段文件的数量限制(WAL日志段文件的大小为16MB)。当该参数值为0时,表示不进行限制。

dn:enable_feedback_cardest

该参数用于另外设置的基于反馈的优化器基数和代价矫正功能开关,用于开发人员诊断模型相关问题。当enable_adaptive_cost参数设置为off,该参数设置为on时,算子信息仍会被收集,反馈基数估计接口仍会被调用,但此时后端自动模型维护的线程不会被启用,开发人员可以通过gs_acm_analyze_workload_manual()函数手动训练模型诊断问题。

dn:enable_global_plsqlcache

设置是否对package、存储过程、函数的编译产物进行全局缓存,执行产物进行session级缓存,开启该功能可以节省高并发下数据库节点的内存使用。

dn:convert_illegal_char_mode

用于在enable_convert_illegal_char参数开启时,设置客户端显示非法编码的占位符。取值范围为ascii编码表中十进制编码为32至126的95个可显示字符。

dn:advance_xlog_file_num

用于控制在后台周期性地提前初始化xlog文件的数目。该参数是为了避免事务提交时执行xlog文件初始化影响性能,但仅在超重负载时才可能出现,因此一般不用配置。

enable_mergejoin

控制优化器是否支持融合连接规划类型。

dn:tde_index_default_encrypt

如果tde_index_default_encrypt=on,创建索引时,如果基表是加密表,则自动将新索引转换为加密索引。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。单位为秒。

enable_global_syscache

控制是否使用全局系统缓存。

dn:max_io_capacity

设置后端写进程批量刷页每秒的IO上限,需要根据具体业务场景和机器磁盘IO能力进行设置,要求RTO很短时间或者数据量比共享内存大多倍的情况,业务访问数据量又是随机访问时,该值不宜过小。设置较小的max_io_capacity会减小后端写进程刷页个数,如果业务触发页面淘汰多时,该值设置小会影响业务。单位为KB。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

index_txntype

设置索引页面格式为PCR或RCR。该值在系统初始化时为空,创建的索引默认兼容老版本索引类型(RCR类型);一旦手动设置该参数后无法再设置为空。

dn:auto_increment_offset

自动增长列的起始值,自增值将由auto_increment_offset + N × auto_increment_increment计算而来,N为正整数。若大于auto_increment_increment自动增长列自增时会产生错误。

autovacuum_naptime

设置两次自动清理操作的时间间隔,缩短该值负载更为平稳,会增加IO消耗,增加该值,负载可能会周期性波动,但是IO消耗会降低。单位为秒。

dn:diskann_probe_ncandidates

表示利用gsdiskann索引检索向量的时候的候选集合大小。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时。单位为秒。

支持修改的参数如下:

表4 分布式参数

参数名称

描述

audit_system_object

该参数决定是否对GaussDB Kernel数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB Kernel数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计,不当修改该参数会导致丢失DDL审计日志,请在技术支持人员指导下进行修改。

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时,单位为秒。

cn:effective_cache_size

设置CN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小,单位为8KB。

cn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

cn:track_stmt_session_slot

设置CN一个session缓存的最大的全量/慢SQL的数量。

datestyle

设置日期和时间值的显示格式。

dn:effective_cache_size

设置DN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小,单位为8KB。

dn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

dn:track_stmt_session_slot

设置DN一个session缓存的最大的全量/慢SQL的数量。

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

enable_slot_log

是否开启逻辑复制槽主备同步特性。

enable_stream_operator

控制优化器对stream的使用。当该参数关闭时,可能会有大量关于计划不能下推的日志记录到日志文件中。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能,单位是毫秒。

max_replication_slots

设置主机端的日志复制slot个数。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。

password_effect_time

该字段决定账户密码的有效时间,单位为天。

password_lock_time

设置账户被锁定后的自动解锁时间,单位为天。

recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置,单位为秒。

timezone

设置显示和解释时间类型数值时使用的时区。

track_stmt_stat_level

控制语句执行跟踪的级别。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错,单位是毫秒。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

cn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

cn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

cn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

cn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

cn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

cn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

cn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

cn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

cn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

cn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔,单位分钟。

cn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

dn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

enable_wdr_snapshot

是否开启WDR 性能快照,开启时内核将定期进行性能视图快照。

cn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。

dn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。

cn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

cn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

cn:recovery_max_workers

并行回放线程个数。

dn:recovery_max_workers

并行回放线程个数。

cn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为ms。

dn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为ms。

cn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。

dn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。

cn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式,单位为百分比。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数,单位天。

cn:enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

dn:enable_default_ustore_table

指定是否开启默认支持Ustore存储引擎,该参数为on时,创建的表类型都为Ustore表。

cn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,单位为8kb。建议不小于undo_limit_size_per_transaction的值。

dn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,单位为8kb。建议不小于undo_limit_size_per_transaction的值。

cn:undo_limit_size_per_transaction

用于控制单事务undo分配空间阈值,达到阈值时事务报错回滚,单位为8kb。建议undo_limit_size_per_transaction的值小于undo_space_limit_size的值,若大于undo_space_limit_size的值,可以设置成功,但是在使用时取两个参数的最小值作为实际的单事务undo分配空间阈值。

dn:undo_limit_size_per_transaction

用于控制单事务undo分配空间阈值,达到阈值时事务报错回滚,单位为8kb。建议undo_limit_size_per_transaction的值小于undo_space_limit_size的值,若大于undo_space_limit_size的值,可以设置成功,但是在使用时取两个参数的最小值作为实际的单事务undo分配空间阈值。

cn:enable_recyclebin

用来控制回收站的实时打开和关闭。

dn:enable_recyclebin

用来控制回收站的实时打开和关闭。

cn:recyclebin_retention_time

设置回收站对象保留时间,超过该时间的回收站对象将被自动清理,单位为秒。

dn:recyclebin_retention_time

设置回收站对象保留时间,超过该时间的回收站对象将被自动清理,单位为秒。

cn:undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间,单位为秒。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。

dn:undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间,单位为秒。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。

cn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

dn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

cn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

dn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

cn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

dn:resilience_ctrlslot_available_maxpercent

最多允许慢SQL占用线程池的的线程占用百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。

cn:resilience_ctrlstmt_control_iopslimit

正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 0(None):表示不对IOPS做限制。 10(LOW):表示对IOPS限制等级为LOW。 20(MEDIUM):表示对IOPS限制等级为MEDIUM。 50(HIGH):表示对IOPS限制等级为HIGH。

dn:resilience_ctrlstmt_control_iopslimit

正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 0(None):表示不对IOPS做限制。 10(LOW):表示对IOPS限制等级为LOW。 20(MEDIUM):表示对IOPS限制等级为MEDIUM。 50(HIGH):表示对IOPS限制等级为HIGH。

dn:resilience_ctrlstmt_detect_timelimit

正常SQL语句被标记为慢SQL的执行时间,0不做慢SQL识别,大于0表示执行的SQL执行时间超过该时间后备标记为慢SQL。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。单位为ms。

表5 主备版参数

参数名称

描述

audit_system_object

该参数决定是否对GaussDB Kernel数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB Kernel数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计,不当修改该参数会导致丢失DDL审计日志,请在技术支持人员指导下进行修改。

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时,单位为秒。

datestyle

设置日期和时间值的显示格式。

dn:wal_keep_segments

“pg_xlog”目录下保留事务日志文件的最小数目。备机通过获取主机此处的日志进行流复制。

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

enable_slot_log

是否开启逻辑复制槽主备同步特性。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能,单位是毫秒。

max_replication_slots

设置主机端的日志复制slot个数。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。

password_effect_time

该字段决定账户密码的有效时间,单位为天。

password_lock_time

设置账户被锁定后的自动解锁时间,单位为天。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置,单位为秒。

timezone

设置显示和解释时间类型数值时使用的时区。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错,单位是毫秒。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:vacuum_defer_cleanup_age

指定VACUUM使用的事务数。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔,单位分钟。

undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间,单位为秒。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。

track_stmt_stat_level

控制语句执行跟踪的级别。

dn:enable_auto_explain

控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询。

enable_wdr_snapshot

是否开启WDR 性能快照,开启时内核将定期进行性能视图快照。

dn:max_concurrent_autonomous_transactions

自治事务最大连接数,同一时间自治事务执行的最大并发数。当设置为0时,将无法执行自治事务。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:recovery_max_workers

并行回放线程个数。

dn:auto_explain_log_min_duration

控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。单位为ms。

dn:recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

dn:audit_function_exec

这个参数决定在执行存储过程、匿名块或自定义函数(不包括系统自带函数)时是否记录审计信息。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式,单位为百分比。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数,单位天。

dn:undo_space_limit_size

用于控制undo强制回收阈值,达到阈值的80%启动强制回收,单位为8kb。建议不小于undo_limit_size_per_transaction的值。

dn:group_concat_max_len

函数GROUP_CONCAT()结果的最大长度。

dn:enable_extension

控制是否支持创建数据库扩展插件。扩展插件属于实验室特性,不推荐使用。

dn:cost_model_version

此参数用来指定优化器代价模型的版本。可以视作一个保护参数,用来禁用最新的优化器代价模型,保持和旧版本计划一致。改变此参数,可能会导致很多SQL计划的改变。因此修改前请谨慎评估。

dn:immediate_analyze_threshold

插入数据后自动做analyze的阈值。当新增数据量达到原有数据量的immediate_analyze_threshold倍,且总行数超过一百时,会自动触发一次analyze。

dn:enable_dynamic_samplesize

是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。

dn:max_io_capacity

设置后端写进程批量刷页每秒的IO上限,需要根据具体业务场景和机器磁盘IO能力进行设置,要求RTO很短时间或者数据量比共享内存大多倍的情况,业务访问数据量又是随机访问时,该值不宜过小。设置较小的max_io_capacity会减小后端写进程刷页个数,如果业务触发页面淘汰多时,该值设置小会影响业务,单位为KB。

dn:max_connections

设置DN允许连接的最大并发连接数。

log_autovacuum_min_duration

设置自动清理时间阈值,当自动清理的执行时间大于或者等于某个特定的阈值,向服务器日志中记录自动清理执行的每一步操作。当参数设置为0时,表示所有的自动清理操作都记录到日志中。当参数设置为-1时,表示所有的自动清理操作都不记录到日志中。

支持修改的参数如下:

表6 分布式参数

参数名称

描述

audit_system_object

该参数决定是否对GaussDB Kernel数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB Kernel数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计,不当修改该参数会导致丢失DDL审计日志,请在技术支持人员指导下进行修改。

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时,单位为秒。

cn:effective_cache_size

设置CN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小,单位为8KB。

cn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

cn:track_stmt_session_slot

设置CN一个session缓存的最大的全量/慢SQL的数量。

datestyle

设置日期和时间值的显示格式。

dn:effective_cache_size

设置DN节点优化器在一次单一的查询中可用的磁盘缓冲区的有效大小,单位为8KB。

dn:enable_hotkeys_collection

是否开启对数据库内的被访问的键值进行统计。

dn:track_stmt_session_slot

设置DN一个session缓存的最大的全量/慢SQL的数量。

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

enable_slot_log

是否开启逻辑复制槽主备同步特性。

enable_stream_operator

控制优化器对stream的使用。当该参数关闭时,可能会有大量关于计划不能下推的日志记录到日志文件中。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能,单位是毫秒。

max_replication_slots

设置主机端的日志复制slot个数。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。

password_effect_time

该字段决定账户密码的有效时间,单位为天。

password_lock_time

设置账户被锁定后的自动解锁时间,单位为天。

recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置,单位为秒。

timezone

设置显示和解释时间类型数值时使用的时区。

track_stmt_stat_level

控制语句执行跟踪的级别。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错,单位是毫秒。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

cn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

cn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

cn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

cn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

cn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

cn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

cn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

cn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

cn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

cn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔,单位分钟。

enable_wdr_snapshot

是否开启WDR 性能快照,开启时内核将定期进行性能视图快照。

cn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

cn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

cn:recovery_max_workers

并行回放线程个数。

dn:recovery_max_workers

并行回放线程个数。

cn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式,单位为百分比。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数,单位天。

表7 主备版参数

参数名称

描述

audit_system_object

该参数决定是否对GaussDB Kernel数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB Kernel数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值,可以只审计需要的数据库对象的操作,在主备强制选主场景建议audit_system_object取最大值,所有DDL对象全部审计,不当修改该参数会导致丢失DDL审计日志,请在技术支持人员指导下进行修改。

autoanalyze

标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。

autoanalyze_timeout

设置autoanalyze的超时时间。在对某张表做autoanalyze时,如果该表的analyze时长超过了autoanalyze_timeout,则自动取消该表此次analyze。0表示不超时,单位为秒。

datestyle

设置日期和时间值的显示格式。

dn:wal_keep_segments

“pg_xlog”目录下保留事务日志文件的最小数目。备机通过获取主机此处的日志进行流复制。

enable_seqscan

控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的,但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

enable_slot_log

是否开启逻辑复制槽主备同步特性。

failed_login_attempts

在任意时候,如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定,password_lock_time秒后被自动解锁,仅sysadmin用户可以访问。

log_min_duration_statement

当某条语句的持续时间大于或者等于特定的毫秒数时,记录每条完成语句的持续时间。设置过低的阈值可能影响负载吞吐,-1表示关闭此功能,单位是毫秒。

max_replication_slots

设置主机端的日志复制slot个数。

max_wal_senders

备DN连接主DN获取物理日志,逻辑复制工具连接主DN获取逻辑日志都会占用walsender线程,此参数标识最大允许创建walsender线程的个数。

password_effect_time

该字段决定账户密码的有效时间,单位为天。

password_lock_time

设置账户被锁定后的自动解锁时间,单位为天。

session_timeout

表明与服务器建立链接后,不进行任何操作的最长时间。0表示关闭超时设置,单位为秒。

timezone

设置显示和解释时间类型数值时使用的时区。

update_lockwait_timeout

允许并发更新参数开启情况下,该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错,单位是毫秒。

wal_level

设置写入WAL信息量的级别,不能为空或被注释掉。此参数设置为logical后才允许进行逻辑日志抽取,此参数设置为logical后xlog日志中会额外记录主键信息。

dn:audit_thread_num

审计线程的个数,取值范围 1~48。

dn:qrw_inlist2join_optmode

控制是否使用inlist-to-join查询重写。

dn:audit_xid_info

是否在审计日志字段detail_info中记录SQL语句的事务ID,0表示关闭,1表示开启。

dn:default_limit_rows

设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数,为负数时代表使用百分比的形式设置默认的估算值,负数转换为默认百分比,即-5代表5%。

dn:audit_dml_state_select

是否对SELECT操作进行审计。

dn:audit_dml_state

是否对具体表的INSERT、UPDATE、DELETE操作进行审计,0表示关闭,1表示开启。

dn:random_page_cost

设置优化器计算一次非顺序抓取磁盘页面的开销。

dn:enable_security_policy

安全策略开关,控制统一审计和数据动态脱敏策略是否生效。

dn:audit_set_parameter

是否对SET操作进行审计,0表示关闭,1表示开启。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:vacuum_defer_cleanup_age

指定VACUUM使用的事务数。

dn:enable_pbe_optimization

设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。

wdr_snapshot_interval

后台Snapshot自动对数据库监控数据执行快照操作的时间间隔,单位分钟。

undo_retention_time

该参数用于闪回查询功能,设置undo日志保留时间,单位为秒。提示:1.本地磁盘undo空间会变大;2.后续增量备份中备份集大小会变大,保留了额外的undo内容。

track_stmt_stat_level

控制语句执行跟踪的级别。

enable_wdr_snapshot

是否开启WDR 性能快照,开启时内核将定期进行性能视图快照。

dn:max_standby_archive_delay

当开启双机热备模式时,如果备机正处理归档WAL日志数据,此时进行查询会产生冲突,此参数就是设置备机取消查询之前所等待的时间,单位为ms。

dn:max_standby_streaming_delay

设置备机取消查询之前等待的时间,单位为ms。

dn:recovery_max_workers

并行回放线程个数。

dn:recovery_time_target

设置recovery_time_target秒能够让备机完成日志写入和回放。单位为秒。

dn:local_syscache_threshold

系统表cache在单个session缓存的大小。单位为KB。

cms:datastorage_threshold_value_check

设置磁盘占用率只读检测阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库节点设置为只读模式,单位为百分比。

wdr_snapshot_retention_days

系统中数据库监控快照数据的保留天数,单位天。

log_autovacuum_min_duration

设置自动清理时间阈值,当自动清理的执行时间大于或者等于某个特定的阈值,向服务器日志中记录自动清理执行的每一步操作。当参数设置为0时,表示所有的自动清理操作都记录到日志中。当参数设置为-1时,表示所有的自动清理操作都不记录到日志中。

dn:max_connections

设置DN允许连接的最大并发连接数。

相关文档