华为云用户手册

  • max_recursive_times 参数说明:控制with recursive的最大迭代次数。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:0 ~ 2147483647 默认值:200。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐根据实际业务评估合理值。 设置不当的风险与影响:对于with recursive语句,此参数用于避免陷入死循环,层次查询可用nocycle跳出循环。若要更改,请在理解参数含义后谨慎操作,避免因误操作产生意料之外的风险。
  • enable_hashagg 参数说明:控制优化器对Hash聚集规划类型的使用。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭后会导致部分场景下Hash聚集算子无法使用,影响查询改写逻辑,使查询性能下降。若要更改,请谨慎操作,避免因误操作产生意料之外的风险。
  • force_bitmapand 参数说明:控制优化器对bitmap and规划类型的强制使用。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:打开该参数后当满足bitmap and索引扫描算子使用条件时,优化器生成计划会强制走bitmap and索引扫描,部分场景下可能影响查询性能。若要更改,请谨慎操作,避免因误操作产生意料之外的风险。
  • enable_bitmapscan 参数说明:控制优化器对位图扫描规划类型的使用。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:on 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭之后会全局禁止bitmap scan算子,可能导致部分场景性能下降。若要更改,请谨慎操作,避免因误操作产生意料之外的风险。
  • enable_hashjoin 参数说明:控制优化器对Hash连接规划类型的使用。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:on 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭后会全局禁止使用Hash Join算子,优先生成其他Join类型计划,可能导致部分场景性能下降。若要更改,请谨慎操作,避免因误操作产生意料之外的风险。
  • resilience_ctrlslot_available_maxpercent 参数说明:最多允许慢SQL占用线程池线程数的百分比。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 参数类型:整型 参数单位:无 取值范围:0 ~ 100 默认值:100,表示允许慢SQL使用所有的线程池线程。 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • max_concurrency 参数说明:管控全局并发数上限。 参数类型:整型 参数单位:无 取值范围:-1 ~ 2147483647 默认值:-1,表示不管控。 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:数据库管理员需根据系统资源(如CPU资源、I/O资源和内存资源)的使用情况,调整此数值大小,使得系统支持最大限度的并发作业操作,并且防止由于并发执行作业过多导致系统崩溃的情况。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_workload_rule 参数说明:设置是否启用SQL限流功能。 参数类型:布尔型 参数单位:无 取值范围: on:表示启用SQL限流功能。 off:表示不启用SQL限流功能。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:如果不需要SQL限流功能,可以设置成off,关闭该功能。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • resilience_ctrlstmt_detect_timelimit 参数说明:正常SQL语句被标记为慢SQL所需的执行时间,0表示不做慢SQL识别,大于0表示当SQL执行时间超过该时间时被标记为慢SQL。仅对非sysadmin/monitoradmin用户执行的select类型的语句生效。 参数类型:整型 参数单位:ms 取值范围:0 ~ 2147483647,0表示关闭慢SQL超时检测功能。 默认值:0 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。例如,不带单位取值6000,表示resilience_ctrlstmt_detect_timelimit为6000ms;带单位取值6s,表示resilience_ctrlstmt_detect_timelimit为6s。取值如果要带单位,必须为ms、s、min、h、d。 设置建议:根据实时数据库执行sql的平均时长来设置。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • session_max_dynamic_memory 参数说明:管控会话级内存上限,会话内存使用超过该值后会报错中断。此参数仅在enable_memory_limit参数取值为on时才生效。该参数可在PDB级别设置。 参数类型:整型 参数单位:kB 取值范围:-1 ~ 2147483647 默认值:-1,表示不管控。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。取值不能带单位。 设置建议:设为默认值,不做调整。 设置不当的风险与影响:该参数不能设置太小,设置太小会导致该会话执行的语句因内存不足失败,若是通过表2中的方式三设置值,且因为内存不足导致无法调大该参数时,只能通过退出会话来消除该限制。当设置的值小于16MB时会给出对应的提示信息。
  • resilience_ctrlstmt_control_iopslimit 参数说明:正常SQL语句被标记为慢SQL后,慢SQL可使用的最大IOPS上限。仅对非sysadmin/monitoradmin用户执行的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空闲时可设置为较大值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • transaction_pending_time 参数说明:设置事务块语句和存储过程语句排队的最大时间。该参数可在PDB级别设置。 参数类型:整型 参数单位:秒(s) 取值范围:-1 ~ 1073741823 值为-1或0时,事务块语句和存储过程语句无超时判断,排队至资源满足可执行条件。 值大于0时,事务块语句和存储过程语句排队超过所设数值的时间后,无视当前资源情况强制执行。 默认值:0。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • workload_uncontrolled_users 参数说明:负载管理的用户白名单列表,位于列表中的用户,不对其进行负载管理,目前仅对SQL限流生效。 参数类型:字符串 参数单位:无 取值范围:用户列表,以“,”分隔,例如“user1, user2, user3”。 默认值:"" 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。 设置建议:根据业务需要设置,对于一些不具备sysadmin权限的用户,但不希望其执行SQL语句时被负载管理限制时,可以添加到该参数中。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • bbox_dump_count 参数说明:在bbox_dump_path定义的路径下,允许存储的 GaussDB 所产生core文件最大数。超过此数量时,旧的core文件会被删除。此参数仅在enable_bbox_dump参数取值为on时才生效。 在并发产生core文件时,core文件的产生个数可能大于bbox_dump_count。 参数类型:整型 参数单位:无 取值范围:1 ~ 20。 默认值:8 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_bbox_dump 参数说明:设置是否开启黑匣子功能,在系统不配置core机制的情况下,是否产生core文件。 参数类型:布尔型 参数单位:无 取值范围: on:表示打开黑匣子功能。 off:表示关闭黑匣子功能。 默认值:on 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。 黑匣子功能生成core文件依赖操作系统开放ptrace接口。若发生权限不足(errno = 1),请确保/proc/sys/kernel/yama/ptrace_scope配置合理。
  • 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时才生效。 参数类型:字符串 参数单位:无 取值范围:以逗号分隔的敏感数据选项组成的字符串。 默认值:""。表示bbox生成的core文件脱敏所有支持的敏感数据项。 目前支持脱敏的数据项: SHARED_BUFFER:buffer数据缓冲区。 X LOG _BUFFER:redo日志缓冲区。 DW_BUFFER:双写数据缓冲区。 XLOG_MESSAGE_SEND:主备日复制日志发送缓冲区。 WALRECEIVER_CTL_BLOCK:主备复制日志接收缓冲区。 DATA_MESSAGE_SEND:主备复制数据发送缓冲区。 DATA_WRITER_QUEUE:主备复制数据接收缓冲区。 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • io_priority 参数说明:I/O利用率高达50%时,重消耗I/O作业进行I/O资源管控时关联的优先级等级。 参数类型:枚举类型 参数单位:无 取值范围: None:表示不受控。 Low:表示限制iops为该作业原始触发数值的10%。 Medium:表示限制iops为该作业原始触发数值的20%。 High:表示限制iops为该作业原始触发数值的50%。 默认值:None 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • 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%。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • query_band 参数说明:用于标识当前会话的作业类型,由用户自定义。该参数可在PDB级别设置。 参数类型:字符串 参数单位:无 取值范围:字符串 默认值:""。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于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。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • topsql_retention_time 参数说明:设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。 参数类型:整型 参数单位:天(d) 取值范围:0 ~ 3650 值为0时,表示数据永久保存。 值大于0时,表示数据能够保存的对应天数。 默认值:0 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • 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%。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_ffic_log 参数说明:设置是否开启FFIC(First Failure Info Capture)功能。 参数类型:布尔型 参数单位:无 取值范围: on:表示打开FFIC功能。 off:表示关闭FFIC功能。 默认值:on 设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • memory_tracking_mode 参数说明:设置记录内存信息的模式。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: none:不启动内存统计功能。 peak:统计query级内存peak值,此数值记入数据库,也可由explain analyze输出。 normal:仅做内存实时统计,不生成文件。 executor:生成统计文件,包含执行层使用过的所有已分配内存的上下文信息。 fullexec:生成统计文件,包含执行层申请过的所有内存上下文信息。 默认值:none。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • enable_resource_track 参数说明:设置是否开启资源实时监控功能。 参数类型:布尔型 参数单位:无 取值范围: on:表示打开资源监控功能。 off:表示关闭资源监控功能。 默认值:on 设置方式:该参数属于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中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • cpu_collect_timer 参数说明:设置语句执行时在数据库节点上收集CPU时间的周期。 参数类型:整型 参数单位:秒(s) 取值范围:1 ~ 2147483647 默认值:30 设置方式:该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议:数据库管理员需根据系统资源(如CPU资源、I/O资源和内存资源)情况,调整此数值大小,使得系统支持较合适的收集周期,太小会影响执行效率,太大会影响异常处理的精确度。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
  • resource_track_level 参数说明:设置当前会话的资源监控的等级。该参数仅在enable_resource_track参数取值为on时才有效。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: none:不开启资源监控功能。 query:开启query级别资源监控功能。 operator:开启query级别和算子级别资源监控功能。 默认值:query。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改,避免出现意料之外的结果。
共99354条