数据仓库服务 GAUSSDB(DWS)-修改GaussDB(DWS)集群GUC参数:功能控制配置参数说明

时间:2025-03-03 19:16:29

功能控制配置参数说明

表1 功能控制配置参数说明

参数名称

参数描述

取值范围

audit_enabled

控制审计进程的开启和关闭。审计进程开启后,将从管道读取后台进程写入的审计信息,并写入审计文件。

on或者off

audit_space_limit

审计文件占用的磁盘空间总量。单位为KB。

1,024 ~ 1,073,741,824

autoanalyze

标识是否允许在生成计划的时候,对于“统计信息完全缺失”或“修改量达到analyze阈值”的表进行统计信息自动收集,当前不支持对外表触发autoanalyze,不支持对带有“ON COMMIT [DELETE ROWS|DROP]”选项的临时表触发autoanalyze,如需收集,需用户手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常,当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作,以同步统计信息数据。

on或者off

autovacuum_max_workers

设置能同时运行的自动清理线程的最大数量。其中0表示不会自动进行autovacuum。

0 ~ 128

autovacuum_max_workers_hstore

设置hstore表automerge的线程数量,该值不能大于autovacuum_max_workers。

修改本参数需要同步调整autovacuum_max_workers为原值加上autovacuum_max_workers_hstore的大小。

0 ~ 128

autovacuum_naptime

设置两次自动清理操作的时间间隔。单位为秒(s)。

1 ~ 2,147,483

autovacuum_vacuum_cost_delay

设置在自动VACUUM操作里使用的开销延迟数值。

-1 ~ 100

behavior_compat_options

数据库兼容性行为配置项,该参数的值由若干个配置项用逗号隔开构成。此参数选项中stric_concat_functions和stric_text_concat_td不能同时设置。

-

checkpoint_segments

设置周期内所保留的最少WAL日志段文件数量。每个日志文件大小为16MB。

1 ~ 2,147,483,646

ddl_lock_timeout

通过该参数单独指定阻塞DDL语句锁等待的时间,当申请的锁等待时间超过设定值时,系统会报错。

0 ~ 2,147,483,647

enable_resource_record

是否开启资源记录功能。

on或者off

enable_resource_track

是否开启资源监控功能。

on或者off

enable_track_record_subsql

设置是否开启子语句记录归档功能。开启时,存储过程、匿名块内部的子语句会被记录归档到相应的INFO表(GS_WLM_SESSION_INFO)。此参数为会话级参数,可在与CN的连接会话中设置生效,仅影响该会话连接中的语句;也可在CN和DN上同时设置,能全局生效。

on或者off

enable_user_metric_persistent

设置是否开启用户历史资源监控转存功能。开启时,对于PG_TOTAL_USER_RESOURCE_INFO视图中数据,会定期采样保存到PG_WLM_USER_RESOURCE_HISTORY系统表中。

on或者off

enable_view_update

用于设置是否开启视图更新功能。

on或者off

extra_float_digits

调整浮点值显示的数据位数,浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上(FLT_DIG或DBL_DIG中合适的)。

-15 ~ 3

failed_login_attempts

输入密码错误的次数达到该参数所设置的值时,账户将会被自动锁定。配置为0时表示不限制密码输入错误的次数。

0 ~ 1,000

instr_unique_sql_count

控制是否收集Unique SQL,以及收集数量限制。

0 ~ 2,147,483,647

job_queue_processes

表示系统可以并发执行的job数目。该参数为postmaster级别,通过gs_guc设置,需要重启gaussdb才能生效。

0 ~ 1,000

lockwait_timeout

控制单个锁的最长等待时间。当申请的锁等待时间超过设定值时,系统会报错。单位为毫秒(ms)。

0 ~ 2,147,483,647

max_active_statements

设置全局的最大并发数量。此参数只应用到CN,且针对一个CN上的执行作业。设置为-1和0表示对最大并发数不做限制。

-1 ~ 2,147,483,647

max_files_per_node

限制单个节点上单个SQL打开的文件最大数量。

-1 ~ 2,147,483,647

max_prepared_transactions

设置可以同时处于“预备”状态的事务的最大数目。增加此参数的值会使 GaussDB (DWS)比系统默认设置需要更多的System V共享内存。

0 ~ 536,870,911

max_process_memory_auto_adjust

设置是否开启max_process_memory参数的自动调整功能。

on或者off

object_mtime_record_mode

用于设置PG_OBJECT系统表中mtime字段的更新行为。

  • default:表示默认行为包括ALTER、COMMENT、GRANT/REVOKE和TRUNCATE操作会更新mtime字段。
  • none:表示不更新mtime字段。
  • disable_acl:表示GRANT/REVOKE操作不更新mtime字段。
  • disable_truncate:表示TRUNCATE操作不更新mtime字段。
  • disable_partition:表示分区表相关ALTER操作不更新mtime字段。

-

plog_merge_age

该参数用于控制性能日志数据输出的周期。

0 ~ 2,147,483,647

random_function_version

控制analyze在进行数据采样时选取的random函数版本。

0 ~ 1

resource_track_cost

设置对语句进行资源监控的最小执行代价。值为-1时,不进行资源监控。值大于或等于0时,执行语句的代价大于或者等于10并且超过这个参数值就会进行资源监控。

-1 ~ 2,147,483,647

resource_track_duration

设置资源监控实时视图中记录的语句执行结束后进行归档的最小执行时间,单位为秒。值为0时,资源监控实时视图中记录的所有语句都进行历史信息归档。值大于0时,资源监控实时视图中记录的语句的执行时间超过所设置的值时进行历史信息归档。

0 ~ 2,147,483,647

resource_track_level

设置当前会话的资源监控的等级。该参数只有当参数enable_resource_track为on时才有效。

  • none:不开启资源监控功能。
  • query:开启query级别资源监控功能,开启此功能会把SQL语句的计划信息(类似explain输出信息)记录到top SQL中。
  • perf:开启perf级别资源监控功能,开启此功能会把包含实际执行时间和执行行数的计划信息(类似explain analyze输出信息)记录到top SQL中。
  • operator:开启operator级别资源监控功能,开启此功能不仅会把包含实际执行时间和执行行数的信息记录到top SQL中,还会把算子级别执行信息刷新到top SQL中。

-

security_enable_options

控制安全模式下可以解禁的操作。

  • grant_to_public:表示允许安全模式下使用grant to public功能。
  • grant_with_grant_option:表示允许安全模式下使用with grant option功能。
  • foreign_table_options:表示允许安全模式下使用外表操作功能,不需要显式赋予用户useft权限。

-

session_timeout

Session闲置超时时间,单位为秒,0表示关闭超时限制。

0 ~ 86,400

space_once_adjust_num

空间管控和空间统计功能中,控制慢速构建与细粒度校准操作中每次处理的文件个数阈值。 0表示不启用慢速构建和细粒度校准功能。 文件个数阈值影响数据库资源,建议合理设置。

说明:

该参数仅8.1.3及以上集群版本支持。

0 ~ 2,147,483,647

statement_timeout

当语句执行时间超过该参数设置的时间(从服务器收到命令时开始计时)时,该语句将会报错并退出执行。单位为毫秒(ms)。

0 ~ 2,147,483,647

timezone

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

-

topsql_retention_time

设置历史TopSQL中gs_wlm_session_info和gs_wlm_operator_info表中数据的保存时间,单位为天。设置此GUC参数启用数据保存功能前,请先清理gs_wlm_session_info和gs_wlm_operator_info表中的数据。

  • 值为0时,表示数据永久保存。
  • 值大于0时,表示数据能够保存的对应天数。

0 ~ 3,650

user_metric_retention_time

设置用户历史资源监控数据的保存天数。该参数仅在enable_user_metric_persistent为on时有效。

0 ~ 3,650

view_independent

用于设置是否开启视图与表、函数、同义词的解耦功能。基表恢复后目前已支持自动关联重建。

on或者off

wlm_memory_feedback_adjust

是否启用动态负载管理的内存负反馈。参数值格式如下所示:

  • on:表示开启内存负反馈。
  • off:表示关闭内存负反馈。

on或者off

enable_generate_plan_hash

设置是否生成plan hash hint_option:设置绑定outline和手工outline生效优先级。当存在手动hint和plan management的hint时,hint生效的优先原则。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

on或者off

turbo_engine_version

控制执行器是否可以走turbo引擎。0代表关闭,3代表所有算子尽可能走turbo引擎。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

0 ~ 3

analyze_predicate_column_threshold

控制开启谓词列analyze。等于0则关闭谓词列收集功能;大于0代表开启谓词列收集功能,且只针对表列数大于等于此值的进行收集,该参数开放主要是提升大表性能。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

0 ~ 10,000

syscache_clean_policy

控制syscache内存的清理策略。

[0,1],[0,1],[0,2147483647]

spill_compression

控制执行器下盘压缩算法。

  • lz4:前向兼容。
  • zstd:新增加压缩算法。
    说明:

    该参数仅存算分离的9.1.0及以上集群版本支持。

-

hudi_sync_max_commits

设置Hudi同步任务同步的最大commits的数量。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

-1 ~ 2,147,483,647

enable_hstore_binlog_table

用于控制是否可以创建binlog表。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

on或者off

binlog_consume_timeout

用于控制在线缩容或vacuum full binlog表时,循环判断binlog记录是否都被消费的超时时间。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

0 ~ 86,400

cu_preload_max_distance

控制列存v3预读加速时对于每个扫描的表允许提前加载的CU id与当前正在加载CU_id的最大距离。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

0 ~ 1,024

cu_preload_count

控制列存v3预读加速时对于每个扫描的表允许提前加载的CU的个数。

说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

0 ~ 10,000

fine_dr_consistency_check_mode

新增细粒度容灾校验一致性的模式。

  • none
  • warning
  • error
说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

-

hint_option

设置绑定outline和手工outline生效优先级。

  • bind_hints_first:当绑定的outline和手工写的hint同时存在时,outline对应版本支持的hint优先手工hint生效。比如:821.001版本的outline支持leading、join、scan hint,那么当SQL语句中存在手工写的这三类hint时,只有outline中的这三类hint生效,手工写的hint不生效。除这三类hint外的手工hint和outline同时生效。
  • ignore_manual_hints:表示语句存在绑定outline时,忽略语句中的手动写的hint。
  • ignore_bind_hints:表示语句存在绑定outline时,忽略绑定的outline中的hint。
说明:

该参数仅存算分离的9.1.0及以上集群版本支持。

-

enable_concurrency_scaling

动态弹性逻辑集群开关。

说明:

该参数仅存算分离的9.1.0.200及以上集群版本支持。

on或者off

concurrency_scaling_max_idle_time

用于指定弹性VW的最大空闲时间,如果超过则进入弹性VW销毁流程。默认单位是分钟。

说明:

该参数仅存算分离的9.1.0.200及以上集群版本支持。

0 ~ 60

concurrency_scaling_limit_per_main_vw

用于限制每个主VW所能拉起的最大弹性VW的数量。

说明:

该参数仅存算分离的9.1.0.200及以上集群版本支持。

0 ~ 32

concurrency_scaling_max_vw_active_statements

用于指定弹性VW上所能执行的最大并发数。

说明:

该参数仅存算分离的9.1.0.200及以上集群版本支持。

0 ~ 1,000,000

concurrency_scaling_max_waiting_statements

用于指定全局排队队列中,触发拉起弹性VW的弹性作业排队数量,如果大于,则进入申请拉起弹性VW流程。

说明:

该参数仅存算分离的9.1.0.200及以上集群版本支持。

0 ~ 1,000,000

support.huaweicloud.com/mgtg-dws/dws_01_0152.html