负载管理
未对数据库资源做控制时,容易出现并发任务抢占资源导致操作系统过载甚至最终崩溃。操作系统过载时,其响应用户任务的速度会变慢甚至无响应;操作系统崩溃时,整个系统将无法对用户提供任何服务。GaussDB的负载管理功能能够基于可用资源的多少均衡数据库的负载,以避免数据库系统过载。
use_workload_manager
参数说明:设置是否开启资源管理功能。多租数据库特性(enable_mtd)需要开启该参数。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开资源管理。
- off:表示关闭资源管理。
默认值:on
设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:资源管理的总开关,关闭会影响很多资源管理的相关功能,不建议关闭。
- 当使用表1中的方式二来修改参数值时,新参数值只能对更改操作执行后启动的线程生效。此外,对于后台线程以及线程复用执行的新作业,该参数值的改动不会生效。如果希望这类线程即时识别参数变化,可以使用kill session或重启节点的方式来实现。
- use_workload_manager参数由off变为on状态后,不会统计off时的存储资源。如果需要统计off时用户使用的存储资源,请在数据库中执行以下SQL语句:
1SELECT gs_wlm_readjust_user_space(0);
enable_control_group
参数说明:设置是否开启Cgroups功能。多租数据库特性(enable_mtd)需要开启该参数。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开Cgroups功能。
- off:表示关闭Cgroups功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置,当使用表中的方式二来修改参数值时,需要重启节点才能使Cgroups功能生效。
设置建议:推荐使用默认值,使用多租数据库时开启该参数。
设置不当的风险与影响:同时开启该参数和资源管控功能(use_workload_manager)后会使用户资源管控功能生效,降低用户执行的作业的性能。
enable_cgroup_switch
参数说明:控制数据库执行语句时是否根据类型自动切换到TopWD组。该参数可在PDB级别设置。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示数据库执行语句时根据类型自动切换到TopWD组。
- off:表示数据库执行语句时根据类型不自动切换到TopWD组。
默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
cgroup_name
参数说明:设置当前使用的Cgroups的名称以及调整当前group下排队的优先级。
如果先设置cgroup_name,再设置session_respool,那么session_respool关联的控制组起作用,如果再修改cgroup_name,那么新修改的cgroup_name起作用。
修改cgroup_name的过程中如果指定Workload控制组级别,数据库不对级别进行验证。级别的范围只要在1-10范围内都可以。
参数类型:字符串
参数单位:无
取值范围:已有控制组的名称。
默认值:"InvalidGroup"
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:尽量不要混合使用cgroup_name和session_respool。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_backend_control
参数说明:控制数据库常驻线程是否绑定到DefaultBackend和HaBackend控制组。多租数据库特性(enable_mtd)需要开启该参数。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示常驻线程绑定到DefaultBackend和HaBackend控制组。
- off:表示常驻线程不绑定到DefaultBackend和HaBackend控制组。
默认值:off
设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。
设置建议:该参数默认关闭,开启后会开启后台线程CPU管控功能,在后台线程消耗CPU高的场景下可以开启该参数来限制后台线程的CPU使用。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
当且仅当enable_control_group参数取值为on时,该参数设置有效。HaBackend控制组用于心跳线程和Wal相关后台线程的CPU管控,保证数据库高可用,在多租数据库特性(enable_mtd)场景下不支持HaBackend控制组。
enable_vacuum_control
参数说明:控制数据库常驻线程中的autoVacuumWorker是否绑定到Vacuum控制组。多租数据库特性(enable_mtd)需要开启该参数。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示数据库常驻线程中的autoVacuumWorker绑定到Vacuum控制组。
- off:表示数据库常驻线程中的autoVacuumWorker不绑定到Vacuum控制组。
默认值:off
设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。
设置建议:该参数默认关闭,开启后会开启后台vacuum线程CPU管控功能,在vacuum线程消耗CPU高的场景下可以开启该参数来限制vacuum线程的CPU使用。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
cpu_collect_timer
参数说明:设置语句执行时在数据库节点上收集CPU时间的周期。
参数类型:整型
参数单位:s(秒)
取值范围:1 ~ 2147483647
默认值:30
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议:数据库管理员需根据系统资源(如CPU资源、I/O资源和内存资源)情况,调整此数值大小,使得系统支持较合适的收集周期,太小会影响执行效率,太大会影响异常处理的精确度。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
memory_tracking_mode
参数说明:设置记录内存信息的模式。该参数可在PDB级别设置。
参数类型:枚举类型
参数单位:无
取值范围:
- none:不启动内存统计功能。
- peak:统计query级内存peak值,此数值记入数据库,也可由explain analyze输出。
- normal:仅做内存实时统计,不生成文件。
- executor:生成统计文件,包含执行层使用过的所有已分配内存的上下文信息。
- fullexec:生成统计文件,包含执行层申请过的所有内存上下文信息。
默认值:none。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
memory_detail_tracking
参数说明:设置需要的线程内分配内存上下文的顺序号以及当前线程所在query的plannodeid,仅用在DEBUG版本。该参数可在PDB级别设置。
参数类型:字符串
参数单位:无
取值范围:字符串
默认值:""。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:该参数不允许用户进行设置,建议保持默认值。
设置不当的风险与影响:无
enable_resource_track
参数说明:设置是否开启资源实时监控功能。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开资源监控功能。
- off:表示关闭资源监控功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_resource_record
参数说明:设置是否开启资源监控记录归档功能。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示开启资源监控记录归档功能。
- off:表示关闭资源监控记录归档功能。
默认值:off
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_logical_io_statistics
参数说明:设置是否开启资源监控逻辑I/O统计功能。开启时,对于PG_TOTAL_USER_RESOURCE_INFO视图中的read_kbytes、write_kbytes、read_counts、write_counts、read_speed和write_speed字段,会统计对应用户的逻辑读写字节数、次数以及速率。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示开启资源监控逻辑I/O统计功能。
- off:表示关闭资源监控逻辑I/O统计功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_instance_metric_persistent
参数说明:设置是否开启实例资源监控转存功能。开启时,对实例的监控数据会保存到GS_WLM_INSTANCE_HISTORY系统表中。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示开启实例资源监控转存功能。
- off:表示关闭实例资源监控转存功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
instance_metric_retention_time
参数说明:设置实例历史资源监控数据的保存天数。该参数仅在enable_instance_metric_persistent参数取值为on时有效。
参数类型:整型
参数单位:d(天)
取值范围:0 ~ 3650
- 值等于0时,实例历史资源监控数据将永久保存。
- 值大于0时,实例历史资源监控数据将保存对应设置天数。
默认值:7
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。取值如果要带单位,必须为d。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
resource_track_level
参数说明:设置当前会话的资源监控的等级。该参数仅在enable_resource_track参数取值为on时才有效。该参数可在PDB级别设置。
参数类型:枚举类型
参数单位:无
取值范围:
- none:不开启资源监控功能。
- query:开启query级别资源监控功能。
- operator:开启query级别和算子级别资源监控功能。
默认值:query。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
resource_track_cost
参数说明:设置对当前会话的语句进行资源监控的最小执行代价。该参数仅在enable_resource_track参数取值为on时才有效。该参数可在PDB级别设置。
参数类型:整型
参数单位:无
取值范围:-1 ~ 2147483647
- 值为-1时,不进行资源监控。
- 值大于等于0且小于等于9时,对执行代价大于等于10的语句进行资源监控。
- 值大于等于10时,对执行代价超过该参数值的语句进行资源监控。
默认值:100000。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
resource_track_duration
参数说明:设置资源监控实时视图中记录的语句执行结束后进行历史信息转存的最小执行时间。当执行完成的作业,其执行时间不小于此参数值时,作业信息会从实时视图(以statistics为后缀的视图)转存到相应的历史视图(以history为后缀的视图)中。该参数仅在enable_resource_track参数取值为on时才有效。该参数可在PDB级别设置。
参数类型:整型
参数单位:s(秒)
取值范围:0 ~ 2147483647
- 值为0时,资源监控实时视图中记录的所有语句都进行历史信息归档。
- 值大于0时,资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。
默认值:60。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。例如,不带单位取值3600,表示resource_track_duration为3600s;带单位取值1h,表示resource_track_duration为1h。取值如果要带单位,必须为s、min、h、d。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
disable_memory_protect
参数说明:设置是否禁止内存保护功能。当系统内存不足时如果需要查询系统视图,可以先将此参数置为on,禁止内存保护功能,保证视图可以正常查询。该参数只适用于在系统内存不足时进行系统诊断和调试,正常运行时请保持该参数配置为off。该参数可在PDB级别设置。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示禁止内存保护功能。
- off:表示启动内存保护功能。
默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,且只对当前会话有效,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
query_band
参数说明:用于标识当前会话的作业类型,由用户自定义。该参数可在PDB级别设置。
参数类型:字符串
参数单位:无
取值范围:字符串
默认值:""。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
memory_fault_percent
参数说明:设置内存故障测试时内存申请失败的比例,仅用在DEBUG版本。
参数类型:整型
参数单位:无
取值范围:0 ~ 2147483647
默认值:0
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_bbox_dump
参数说明:设置是否开启黑匣子功能,在系统不配置core机制的情况下,是否产生core文件。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开黑匣子功能。
- off:表示关闭黑匣子功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
黑匣子功能生成core文件依赖操作系统开放ptrace接口。若发生权限不足(errno = 1),请确保/proc/sys/kernel/yama/ptrace_scope配置合理。
bbox_dump_count
参数说明:在bbox_dump_path定义的路径下,允许存储的GaussDB所产生core文件最大数。超过此数量时,旧的core文件会被删除。此参数仅在enable_bbox_dump参数取值为on时才生效。
在并发产生core文件时,core文件的产生个数可能大于bbox_dump_count。
参数类型:整型
参数单位:无
取值范围:1 ~ 20
默认值:8
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
bbox_dump_path
参数说明:黑匣子core文件的生成路径。此参数仅在enable_bbox_dump参数取值为on时才生效。
参数类型:字符串
参数单位:无
取值范围:合法文件路径。
默认值:""。默认生成黑匣子core文件的路径为读取"/proc/sys/kernel/core_pattern"下的路径,如果这个路径不是一个目录,或者用户对此目录没有写权限,黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
bbox_blanklist_items
参数说明:黑匣子core文件的脱敏数据选项。此参数仅在enable_bbox_dump参数取值为on时才生效。
参数类型:字符串
参数单位:无
取值范围:以逗号分隔的敏感数据选项组成的字符串。
目前支持脱敏的数据项:
- SHARED_BUFFER:buffer数据缓冲区。
- XLOG_BUFFER:redo日志缓冲区。
- DW_BUFFER:双写数据缓冲区。
- XLOG_MESSAGE_SEND:主备复制日志发送缓冲区。
- WALRECEIVER_CTL_BLOCK:主备复制日志接收缓冲区。
- DATA_MESSAGE_SEND:主备复制数据发送缓冲区。
- DATA_WRITER_QUEUE:主备复制数据接收缓冲区。
- BUCKET_XLOG_MESSAGE_SEND:bucket扩容回放日志发送缓冲区。
默认值:""。表示bbox生成的core文件脱敏所有支持的敏感数据项。
设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_ffic_log
参数说明:设置是否开启FFIC(First Failure Info Capture)功能。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开FFIC功能。
- off:表示关闭FFIC功能。
默认值:on
设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
io_limits
参数说明:设置每秒触发I/O的上限。
参数类型:整型
参数单位:无
取值范围:0 ~ 1073741823
默认值:0
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
io_priority
参数说明:I/O利用率高达50%时,重消耗I/O作业进行I/O资源管控时关联的优先级等级。
参数类型:枚举类型
参数单位:无
取值范围:
- None:表示不受控。
- Low:表示限制iops为该作业原始触发数值的10%。
- Medium:表示限制iops为该作业原始触发数值的20%。
- High:表示限制iops为该作业原始触发数值的50%。
默认值:None
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
io_control_unit
参数说明:行存场景下,I/O管控时用来对I/O次数进行计数的单位。
记多少次I/O触发为一计数单位,通过此计数单位所记录的次数进行I/O管控。
参数类型:整型
参数单位:无
取值范围:1000 ~ 1000000
默认值:6000
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
session_respool
参数说明:设置当前的session关联的resource pool。
如果先设置cgroup_name,再设置session_respool,那么session_respool关联的控制组起作用,如果再修改cgroup_name,那么新修改的cgroup_name起作用。
修改cgroup_name的过程中如果指定Workload控制组级别,数据库不对级别进行验证。级别的范围只要在1-10范围内都可以。
参数类型:字符串
参数单位:无
取值范围:通过create resource pool所设置的资源池的名称。
默认值:"invalid_pool"
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:尽量不要混合使用cgroup_name和session_respool。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
session_statistics_memory
参数说明:设置实时查询视图的内存大小。
参数类型:整型
参数单位:kB
取值范围:5120 ~ 2147483647
默认值:5120(即5MB)
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。例如,不带单位取值16384,表示session_statistics_memory为16384kB;带单位取值16MB,表示session_statistics_memory为16MB。取值如果要带单位,必须为kB、MB、GB。
设置建议:建议取值不大于max_process_memory的50%。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
session_history_memory
参数说明:设置历史查询视图的内存大小。
参数类型:整型
参数单位:kB
取值范围:10240 ~ 2147483647
默认值:10240(即10MB)
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。例如,不带单位取值16384,表示session_history_memory为16384kB;带单位取值16MB,表示session_history_memory为16MB。取值如果要带单位,必须为kB、MB、GB。
设置建议:建议取值不大于max_process_memory的50%。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
topsql_retention_time
参数说明:设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。
参数类型:整型
参数单位:d(天)
取值范围:0 ~ 3650
- 值为0时,表示数据永久保存。
- 值大于0时,表示数据能够保存的对应天数。
默认值:0
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
transaction_pending_time
参数说明:设置事务块语句和存储过程语句排队的最大时间。该参数可在PDB级别设置。
参数类型:整型
参数单位:s(秒)
取值范围:-1 ~ 1073741823
- 值为-1或0时,事务块语句和存储过程语句无超时判断,排队至资源满足可执行条件。
- 值大于0时,事务块语句和存储过程语句排队超过所设数值的时间后,无视当前资源情况强制执行。
默认值:0。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
current_logic_cluster
参数说明:显示当前的逻辑数据库实例名称。
参数类型:字符串
参数单位:无
取值范围:逻辑数据库实例名称。
默认值:""
设置方式:该参数属于INTERNAL类型参数,为固定参数,用户无法修改此参数,只能查看。
设置建议:该参数不允许用户进行设置,只能查看。
设置不当的风险与影响:无
resilience_ctrlslot_available_maxpercent
参数说明:最多允许慢SQL占用线程池线程数的百分比。仅对非sysadmin/moadmin用户执行的select类型的语句生效。
参数类型:整型
参数单位:无
取值范围:0 ~ 100
默认值:100,表示允许慢SQL使用所有的线程池线程。
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
resilience_ctrlstmt_detect_timelimit
参数说明:正常SQL语句被标记为慢SQL所需的执行时间,0表示不做慢SQL识别,大于0表示当SQL执行时间超过该时间时被标记为慢SQL。仅对非sysadmin/monadmin用户执行的select类型的语句生效。同时可用于异常SQL CPU资源管控特性中识别异常SQL。
参数类型:整型
参数单位:ms(毫秒)
取值范围:0 ~ 2147483647,0表示关闭慢SQL超时检测功能。
默认值:1000
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。例如,不带单位取值6000,表示resilience_ctrlstmt_detect_timelimit为6000ms;带单位取值6s,表示resilience_ctrlstmt_detect_timelimit为6s。取值如果要带单位,必须为ms、s、min、h、d。
设置建议:根据实时数据库执行sql的平均时长来设置。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
resilience_ctrlstmt_control_iopslimit
参数说明:正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monadmin用户执行的select类型的语句生效。
参数类型:字符串
参数单位:无
取值范围:"Low"、"Medium"、"High"、"None"、0 ~ 2147483647。级别越低管控越严格。
- "Low":低级。
- "Medium":中级。
- "High":高级。
- "None":关闭慢SQL逻辑I/O管控功能。
- 0 ~ 2147483647:数值越小越严格,越大越宽松。
默认值:"None"
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。如果设置为数值,需要使用字符串的形式,如resilience_ctrlstmt_control_iopslimit = '1024'。
设置建议:I/O访问满时设置为较小值,I/O空闲时可设置为较大值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
session_max_dynamic_memory
参数说明:管控会话级内存上限,会话内存使用超过该值后会报错中断。此参数仅在enable_memory_limit参数取值为on时才生效。该参数可在PDB级别设置。
参数类型:整型
参数单位:kB
取值范围:-1 ~ 2147483647
默认值:-1,表示不管控。在PDB场景内,若未设置该参数,则继承来自全局的设置。
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。取值不能带单位。
设置建议:设为默认值,不做调整。
设置不当的风险与影响:该参数不能设置太小,设置太小会导致该会话执行的语句因内存不足失败,若是通过表2中的方式三设置值,且因为内存不足导致无法调大该参数时,只能通过退出会话来消除该限制。当设置的值小于16MB时会给出对应的提示信息。
max_concurrency
参数说明:管控全局并发数上限。
参数类型:整型
参数单位:无
取值范围:-1 ~ 2147483647
默认值:-1,表示不管控。
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:数据库管理员需根据系统资源(如CPU资源、I/O资源和内存资源)的使用情况,调整此数值大小,使得系统支持最大限度的并发作业操作,并且防止由于并发执行作业过多导致系统崩溃的情况。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_workload_rule
参数说明:设置是否启用SQL限流功能。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示启用SQL限流功能。
- off:表示不启用SQL限流功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:如果不需要SQL限流功能,可以设置成off,关闭该功能。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
enable_sysadmin_workload_rule
参数说明:设置是否启用管理员SQL限流功能。该参数对superuser无效,superuser始终不受限流规则影响。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示启用管理员SQL限流功能。
- off:表示不启用管理员SQL限流功能。
默认值:off
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:建议保持默认值off。仅在需要对管理员用户执行的SQL进行限流时,设置为on。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
workload_uncontrolled_users
参数说明:负载管理的用户白名单列表,位于列表中的用户,不对其进行负载管理,目前仅对SQL限流生效。
参数类型:字符串
参数单位:无
取值范围:用户列表,以“,”分隔,例如“user1, user2, user3”。
默认值:""
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:根据业务需要设置,对于一些不具备sysadmin权限的用户,但不希望其执行SQL语句时被负载管理限制时,可以添加到该参数中。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
max_plancache_memory_ratio
参数说明:用于控制session级prepare statement和cursor_sharing的计划缓存占用动态内存的百分比阈值。
参数类型:整型
参数单位:无
取值范围:0 ~ 100
该参数是一个取值范围在0 ~ 100的整型数,其含义为当前session中计划缓存的上限占“预期为每个session预留内存”的百分比阈值。设置为0表示禁用该功能。
系统动态内存预期为每个session预留的内存大小遵从如下表1规则:
| CurConnCount/ max_connections | 预期为每个session预留内存 |
|---|---|
| 0 ~ 30% | max_dynamic_memory / (max_connections * 30%) |
| 30% ~ 60% | max_dynamic_memory / (max_connections * 60%) |
| 60% ~ 100% | max_dynamic_memory / (max_connections * 100%) |
其中,CurConnCount表示当前session个数。max_connections表示最大并发session数,由GUC参数max_connections控制。max_dynamic_memory表示系统最大的动态内存。
当系统监测到计划缓存占用的内存大小与Session预留内存的比值达到或超过参数max_plancache_memory_ratio设定的百分比阈值时,将触发缓存淘汰机制。该机制通过LRU(最近最少使用)算法释放计划缓存条目,直至当前计划缓存内存占比回落到阈值以下。被淘汰的缓存条目在后续重新执行时,系统将自动生成新的执行计划以确保查询正常执行。
默认值:60(256核CPU/2048G内存,192核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内存);40(8核CPU/64G内存,4核CPU/32G内存,4核CPU/16G内存)
设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。
设置建议:如果该参数设置的百分比过小,则会频繁触发计划缓存淘汰、重建,有导致性能劣化的风险,需要根据实际内存使用情况慎重设置。对于混合部署场景需要基于单个进程分配的内存考虑,调整参数配置。该参数仅控制session级prepare statement和cursor_sharing的计划缓存占用的动态内存,其他内存不在管控范围内。
当前参数配置基于内存配置、连接数以及性能考虑给出。当计划内存占用过多,可能导致max_dynamic_memory占满,或触发内存淘汰导致性能劣化。在这类特殊场景下,建议根据业务调整内存比例大小。
另外,在GUC参数enable_opfusion取值为on的场景下,session级别的opfusion相关内存暂未纳入该参数控制,存在这部分内存不受控制的风险,如果出现此类问题,建议降低GUC参数max_plancache_memory_ratio的取值以缓解此类问题。
设置不当的风险与影响:如果该参数设置的百分比过小,则会频繁触发计划缓存淘汰、重建,有导致性能劣化的风险;如果该参数设置的百分比过大,可能会导致内存资源紧张,仍有资源不可用的风险。请在充分理解参数含义,并经过测试验证后进行修改。
- 该参数设置后,需要将参数enable_memory_limit打开才能生效。
- 最大动态内存可以通过pv_total_memory_detail视图查询获得,对应字段为:max_dynamic_memory。最大连接数可以通过GUC参数max_connections查看。
- 缓存淘汰只在执行计划创建、重建后内存大小达到或超过上限后触发。当新session连接后,占比从表1中给出的区间之间跳变时(例如从29%增加到31%),为每个session预留内存随之改变,注意此时并不会被动触发淘汰。
- 版本升级后,该参数默认关闭,即值为0。
enable_abnormal_sql_cpu_detect
参数说明:识别异常SQL对CPU资源使用的功能开关。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示启用SQL异常使用CPU资源识别功能。
- off:表示关闭SQL异常使用CPU资源识别功能。
默认值:on
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:关闭该参数后,将停止对异常SQL语句的CPU资源识别。
abnormal_sql_cpu_util_percent
参数说明:用于设定异常SQL CPU资源管控功能的GaussDB进程CPU使用率阈值,当GaussDB CPU资源占用率达到设置阈值时,管控功能生效。多租数据库特性(enable_mtd)开启时,本参数失效。
参数类型:整型
参数单位:无
取值范围:-1 ~ 100
- -1:表示关闭异常SQL CPU资源管控功能。
- >=0:表示开启异常SQL CPU资源管控功能,设置管控功能生效的阈值。
默认值:80
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。依赖CPU资源识别功能,仅在enable_abnormal_sql_cpu_detect为on时,对本参数进行设置才有意义。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
abnormal_sql_cpu_hist_multiplier
参数说明:异常SQL CPU耗时超过历史均值倍数的标准。
参数类型:整型
参数单位:无
取值范围:1 ~ 10000
默认值:2
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
abnormal_sql_effective_count
参数说明:检测到SQL使用CPU资源超过历史均值倍数(abnormal_sql_cpu_hist_multiplier)的次数。
参数类型:整型
参数单位:无
取值范围:1 ~ 2147483647
默认值:10
设置方式:该参数属于SIGHUP类型参数,请参见设置参数中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
abnormal_sql_control_duration
参数说明:异常SQL接受CPU资源管控的持续时间。
参数类型:整型
参数单位:h(小时)
取值范围:1 ~ 240000
默认值:24
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
abnormal_sql_control_type
参数说明:异常SQL需要被CPU管控的类型。
参数类型:字符串
参数单位:无
取值范围:当前版本仅支持设置为sql_plan_multiplier、sql_abnormal_manual或sql_abnormal_other,当需要对多个异常SQL类型进行管控时,使用逗号进行分隔。
默认值:“sql_plan_multiplier, sql_abnormal_manual”
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:推荐使用默认值。
设置不当的风险与影响:该参数设置后,识别出的异常SQL的类型如果是设置的类型,则会被强制进行CPU管控,不在设置的类型范围内的只做异常SQL的识别,不做管控,请在充分理解参数含义,并经过测试验证后进行修改。
enable_emergency_access
参数说明:控制是否开启Unix Domain Socket运维通道,后称“应急通道”。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示开启应急通道功能。
- off:表示不开启应急通道功能。
默认值:on
设置方式:该参数属于POSTMASTER类型参数,请参见表2中对应设置方法进行设置。
设置建议:建议使用默认值。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
enable_serverless
参数说明:用于控制是否开启Serverless模式。
参数类型:布尔型
参数单位:无
取值范围:
- on:表示打开Serverless模式。
- off:表示关闭Serverless模式。
默认值:off
设置方式:该参数属于POSTMASTER类型参数,请参见表2中对应设置方法进行设置。
设置建议:在数据库安装时由实际部署环境决定Serverless模式是否打开,不建议用户自行修改该参数取值。
设置不当的风险与影响:修改该参数取值可能导致数据库内存管理、连接数管理等资源管理功能异常,请在充分理解参数含义,并经过测试验证后进行修改,避免出现非预期的结果。
- 当打开enable_serverless开关时,系统保证至少2GB动态内存可用,确保内存保护机制不会因共享内存预分配过大而自动关闭。如果需要更大内存,请调整参数max_process_memory和shared_buffers。
- 当打开enable_serverless开关后,系统可用动态内存低于4GB时,自动关闭后台线程预留功能(由参数enable_threads_memory_reserve控制),避免预留内存占用过多导致基本功能异常。
resource_expansion_strategy
参数说明:用于控制资源规格动态调整功能的开关。
参数类型:字符串
参数单位:无
取值范围:
所有支持的配置开关可通过SHOW resource_expansion_strategy查看:
ALL,on(),off(memory,connection)
- memory:开启后,参数max_process_memory和shared_buffers支持reload生效。
- connection:开启后,最大连接数max_connections支持根据内存规格动态调整。
- 当需要关闭功能时,仅支持设置resource_expansion_strategy为"off(ALL)",不支持单独关闭指定的开关(如:"off(memory)")。
- 当需要开启功能时,支持设置"on(ALL)"以全部开启,也支持单独开启指定的开关(如:"on(memory)")。
默认值:"ALL,on(),off(memory,connection)",即关闭所有动态调整功能的开关。
设置方式:该参数属于POSTMASTER类型参数,请参见表2中对应设置方法进行设置。
首先,通过SHOW resource_expansion_strategy来查看哪些行为变更是支持可控制的。例如,查询输出结果为:
gaussdb=# show resource_expansion_strategy; resource_expansion_strategy --------------------------------- ALL,on(),off(memory,connection) (1 row)
可以使用on/off来控制动态调整功能是否生效。其中,特殊标识ALL与on/off搭配使用可用于对所有动态调整功能进行设置。
例如,设置memory类策略支持动态调整,可使用如下gs_guc工具命令:
gs_guc set -I all -N all -Z datanode -c "resource_expansion_strategy='on(memory)'"
设置后,需要重启数据库,再次执行SHOW resource_expansion_strategy,可以看到memory类策略开关打开:
gaussdb=# SHOW resource_expansion_strategy; resource_expansion_strategy --------------------------------- ALL,on(memory),off(connection) (1 row)
设置建议:在数据库安装时由实际部署环境决定resource_expansion_strategy是否打开,该参数仅适用于DCS/serverless平台支持硬件规格扩缩容的场景使用,其他场景不建议用户自行修改该参数取值。
设置不当的风险与影响:修改该参数取值可能影响数据库内存管理、连接数管理等资源管理功能和数据库性能。高负载场景下,如果执行机器的扩缩容操作,可能会导致业务受损。
- 当开启参数enable_serverless时,自动设置resource_expansion_strategy为"on(ALL)",即"ALL,on(memory,connection),off()"。
- 当打开memory开关时,系统保证至少2GB动态内存可用,确保内存保护机制不会因共享内存预分配过大而自动关闭。如果需要更大内存,请调整参数max_process_memory和shared_buffers。
- 当打开memory开关后,系统可用动态内存低于4GB时,自动关闭后台线程预留功能(由参数enable_threads_memory_reserve控制),避免预留内存占用过多导致基本功能异常。
global_plancache_memory_ratio
参数说明:用于控制全局共享计划缓存占用动态内存的百分比阈值,0表示关闭GPC内存管控。
参数类型:整型
参数单位:无
取值范围:0 ~ 80
默认值:30(256核CPU/2048G内存,192核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内存);20(4核CPU/32G内存,4核CPU/16G内存)
设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。
设置建议:如果该参数设置的百分比过小,可能会导致计划缓存无法共享,需要根据实际内存使用情况慎重设置。
对于不同内存规格环境建议调整参数设置,可参考出口参数设置。
混合部署场景需要基于单个进程分配的内存考虑,调整参数配置。
当前参数配置基于内存配置以及性能考虑给出。当计划内存占用过多,可能导致max_dynamic_memory占满,或触发内存淘汰导致性能劣化。在这类特殊场景下,建议根据业务调整内存比例大小。
设置不当的风险与影响:如果该参数设置的百分比过小,可能会导致大量计划缓存无法共享;如果该参数设置的百分比过大,可能会导致内存资源紧张,仍有资源不可用的风险。请在充分理解参数含义,并经过测试验证后进行修改。