华为云用户手册

cost_update_window_size 参数说明：该参数用于调整收集用于回归的数据的滑动窗口大小。该参数可在PDB级别设置。 参数类型：整型 参数单位：个 取值范围：1 ~ 20 默认值：5。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数值小于3可能会导致估计代价参数过拟合与实际情况产生误差，使优化器生成错误的执行计划。

adaptive_cardest_strategy 参数说明：该参数用于设置选择基数估计模型偏好。该参数可在PDB级别设置。 参数类型：枚举类型 参数单位：无 取值范围："auto"、"use_statistics"、"use_feedback" "auto"：自适应模式，自动根据估计的历史准确性判断是使用统计方法还是反馈方法。 "use_statistics"：优先使用统计信息做基数估计。 "use_feedback"：优先使用反馈模型做基数估计。 默认值："auto"。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：运行过程中修改该参数有计划劣化风险。

enable_ai_watchdog_forcible_oom_detection 参数说明：强制开启或关闭AI Watchdog的OOM探测功能，若关闭该参数，则会自动根据当前数据库的规格判断是否需要启动OOM探测功能。自动判断模式下，对于max_process_memory设置为64GB及以上的场景，才会启动OOM探测功能。由于OOM探测功能依赖内存管理模块获取的信息，因此，如果内存管理模块未开启或失效，则OOM探测功能也不会启用。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：功能打开会占用系统资源。

maximal_feedback_model_num 参数说明：该参数用于设置基数反馈模型数量上限，超过此上限后不再训练新的模型。 参数类型：整型 参数单位：个 取值范围：-1 ~ 1000000。值为-1表示无上限。 默认值：10000 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果基数反馈模型数量上限设置过小，可能会因无法训练新的模型而导致反馈基数估计功能失效；如果数量上限设置过大，可能会占用过多的磁盘空间，造成性能下降。

feedback_model_expired_time 参数说明：该参数用于设置基数反馈模型超时时间，过期的模型会定期被清理。 参数类型：整型 参数单位：毫秒（ms） 取值范围：500 ~ 2147483647 默认值：86400000（即1d） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示feedback_model_expired_time为6000ms；带单位取值1min，表示feedback_model_expired_time为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果超时时间设置过长会造成系统性能下降；如果设置过短会导致模型被清理频率过高而影响功能。

adaptive_cost_min_time 参数说明：该参数用于设置基数反馈收集的SQL时间阈值，只有执行时间大于该值的语句反馈会被收集。该参数可在PDB级别设置。 参数类型：整型 参数单位：毫秒（ms） 取值范围：0 ~ 2147483647 默认值：1000。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示adaptive_cost_min_time为6000ms；带单位取值1min，表示adaptive_cost_min_time为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：建议设置为需要调优的慢查询执行时长的20%。 设置不当的风险与影响：如果时间参数设置过短，最严重造成1-2%系统性能下降；如果设置过长则会导致能够被自动调优的查询不在功能生效范围内。

enable_ai_stats 参数说明：该参数用于指定是否创建或者使用智能统计信息。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示创建并且使用智能统计信息。 off：表示不创建或者不适用智能统计信息。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：数据库运行过程中修改可能会造成计划劣化。

enable_cachedplan_mgr 参数说明：该参数用于指定是否开启自适应计划选择功能。自适应计划选择弥补了传统单一缓存计划无法根据查询条件参数进行变化带来的性能问题，并且避免了频繁调用查询优化。开启此功能后，用户可以通过维护多个缓存计划实现适应不同的查询参数，从而提升查询执行性能。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启自适应计划选择功能。 off：表示不开启自适应计划选择功能。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：开启此参数有助于提升查询性能，关闭此参数可能导致查询性能的降低。

db4ai_snapshot_version_separator 参数说明：该参数用于指定数据表快照子版本分隔符。该参数可在PDB级别设置。 参数类型：字符串 参数单位：无 取值范围：字符串长度需设置为1，即一个字符，如："@"，"#"等，需要注意的是"?"是非法字符。 默认值："."。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_adaptive_cost 参数说明：该参数为基于反馈的优化器基数和代价矫正功能的总开关，打开后开启算子信息收集流程和基数估计流程，后端模型维护的启动线程会随此参数开关启动或退出。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启算子信息流程和基数估计流程。 off：表示关闭算子信息流程和基数估计流程。 默认值： on：新安装的数据库的默认值。 off：505.1.0版本之前的数据库升级后的默认值。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。请根据查询语句是否需要自动调优开启/关闭此参数。 设置不当的风险与影响：不需要该功能的场景下，比如业务中不存在需要调优的复杂语句时，打开功能会占用更多系统资源。

enable_operator_prefer 参数说明：该参数用于指定是否开启算子倾向性规则，在估计代价相近的情况下，倾向于选择参数化路径执行表连接。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启参数化路径优先。 off：表示不开启参数化路径优先。 默认值：off 此参数生效有两个必要的前置条件： 参数化路径被生成。 参数化路估计的代价和其他索引扫描算子类似。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值，推荐只在session或者hint内指定该参数设置。 设置不当的风险与影响：修改此参数会有严重的计划劣化风险。

recommend_session_aplan_memory 参数说明：该参数用于控制自适应计划选择每个session中的候选计划内存上限，大于或者等于这个值之后将不再在内存中插入新的候选计划，该参数可在PDB级别设置。 参数类型：整型 参数单位：kB 取值范围：1024 ~ 102400 默认值：5120。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数数值过高可能导致功能消耗太多内存影响业务运行资源，数值过低可能导致功能无法缓存计划，增高时延。

ai_stats_cache_limit 参数说明：该参数用于指定在enable_ai_stats为on状态下最多缓存的模型数量。该参数可在PDB级别设置。 参数类型：整型 参数单位：个 取值范围：30 ~ 1000。 默认值：100。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议根据使用多列统计信息模型数量设置。 设置不当的风险与影响：最大缓存个数设置过大会占用不必要的内存，参数设置过小会频繁从硬盘读取模型，造成系统性能下降。

max_stmt_aplan_num 参数说明：该参数用于控制自适应计划选择每个查询的候选计划个数上限。该参数可在PDB级别设置。 参数类型：整型 参数单位：个 取值范围：0 ~ 20 默认值：5。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数数值过高可能导致功能消耗太多内存影响业务运行资源，数值过低可能导致功能无法缓存计划，增高时延。

repick_plan_min_duration 参数说明：该参数用于控制探测到的计划的可用下限，在策略探测时，如果被探测策略的执行时间不小于cplan的repick_plan_min_duration倍，将直接报错。注意设置为0的时候表示关闭报错机制。该参数可在PDB级别设置。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647 默认值：0。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数数值大于0可能会造成语句运行报错，数值越低，报错可能越高；数值过高可能会让错误计划长时间执行占用系统资源。

multi_stats_type 参数说明：该参数用于指定在enable_ai_stats为on状态下创建的统计信息类别。该参数可在PDB级别设置。 参数类型：枚举类型 参数单位：无 取值范围：有效值为“BAYESNET”、“MCV”、“ALL”。 "BAYESNET"：只创建智能统计信息。 "MCV"：只创建传统统计信息。 "ALL"：同时创建传统统计信息和智能统计信息。 默认值："BAYESNET"。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

db4ai_snapshot_mode 参数说明：snapshot有2种模式：MSS（物化模式，存储数据实体）和 CSS （计算模式，存储增量信息）。该参数可在PDB级别设置。 参数类型：字符串 参数单位：无 取值范围："MSS"，" CS S" "MSS"：表示物化模式，db4ai在创建快照的时候存储数据实体。 "CSS"：表示计算模式，db4ai在创建快照的时候存储增量信息。 默认值："MSS"。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值，可以根据实际业务需要进行调整。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_hypo_index 参数说明：该参数控制数据库的优化器进行EXPLAIN时是否创建虚拟索引。通过对特定的查询语句执行explain，用户可根据优化器给出的执行计划评估该索引是否能够提升该查询语句的执行效率。 参数类型：布尔型 参数单位：无 取值范围： on：表示在进行EXPLAIN时创建虚拟索引。 off：表示在进行EXPLAIN时不创建虚拟索引。 默认值：off 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据业务需要进行调整。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

db4ai_snapshot_version_delimiter 参数说明：该参数为数据表快照版本分隔符。该参数可在PDB级别设置。 参数类型：字符串 参数单位：无 取值范围：字符串长度需设置为1，即一个字符，如："@"，"#"等，需要注意的是"!"是非法字符。 默认值："@"。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

GLOBAL_STAT_DATABASE 显示数据库各节点的统计信息（不同节点下数据库的状态信息不汇总），如表1所示。 表1 GLOBAL_STAT_DATABASE字段 名称 类型 描述 node_name name 节点名称。 datid oid 数据库的OID。 datname name 这个数据库的名称。 numbackends integer 当前连接到该数据库的后端数。 xact_commit bigint 此数据库中已经提交的事务数。 xact_rollback bigint 此数据库中已经回滚的事务数。 blks_read bigint 在这个数据库中读取的磁盘块的数量。 blks_hit bigint 高速缓存中已经命中的磁盘块的次数，这种情况下不需要从磁盘读取（高速缓存只包括数据库内核缓冲区高速缓存，不包括操作系统的文件系统缓存）。 tup_returned bigint 该数据库中顺序扫描获取的活跃行数和索引扫描返回的索引行数。 tup_fetched bigint 当前数据库通过索引返回的行数。 tup_inserted bigint 插入的行数。 tup_updated bigint 更新的行数。 tup_deleted bigint 删除的行数。 conflicts bigint 由于与数据库回放发生冲突而取消的查询数量（冲突仅在备机上发生）。请参见STAT_DATABASE_CONFLI CTS 获取更多信息。 temp_files bigint 该数据库中查询语句创建的临时文件数量。统计所有临时文件，不受GUC参数log_temp_files设置值影响。 temp_bytes bigint 该数据库中查询语句写入临时文件的数据总量。统计所有临时文件，不受GUC参数log_temp_files设置值影响。 deadlocks bigint 在该数据库中检索的死锁数。 blk_read_time double precision 通过数据库后端读取数据文件块花费的时间，以毫秒计算。 blk_write_time double precision 通过数据库后端写入数据文件块花费的时间，以毫秒计算。 stats_reset timestamp with time zone 重置当前状态统计的时间。 父主题： Object

delete_cctmp_table 参数说明：控制是否删除Ustore在线创建/重建索引过程中产生的临时表。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示删除临时表。 off：表示保留临时表。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：该参数默认开启，需要保留在线创建/重建索引过程中产生的临时表时设置为off。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

语法格式 1 2 ALTER RESOURCE POOL pool_name WITH ({MEM_PERCENT= pct | CONTROL_GROUP="group_name" | ACTIVE_STATEMENTS=stmt | MAX_DOP = dop | MEMORY_LIMIT="memory_size" | io_limits=io_limits | io_priority="io_priority" | max_worker=max_worker | max_connections=max_connections | max_dynamic_memory="max_dynamic_memory"| max_shared_memory="max_shared_memory" | max_concurrency=concurrency}[, ... ]);

参数说明 pool_name 资源池名称。 资源池名称为已创建的资源池。 取值范围：字符串，要符合标识符命名规范。 group_name 控制组名称。 设置控制组名称时，语法可以使用双引号，也可以使用单引号。 group_name对大小写敏感。 若数据库管理员指定自定义Class组下的Workload控制组，如control_group的字符串为："class1:workload1"；代表此资源池指定到class1控制组下的workload1控制组。也可同时指定Workload控制组的层次，如control_group的字符串为："class1:workload1:1"。 若数据库用户指定Timeshare控制组代表的字符串，即"Rush"、"High"、"Medium"或"Low"其中一种，如control_group的字符串为"High"；代表资源池指定到DefaultClass控制组下的"High" Timeshare控制组。 取值范围：已创建的控制组。 stmt 资源池语句执行的最大并发数量，-1表示不限制并发数。 取值范围：数值型，-1~2147483647‬。 dop 资源池最大并发度，语句执行时能够创建的最多线程数量。 取值范围：数值型，1~2147483647‬。 memory_size 资源池最大使用内存。 取值范围：字符串，内容范围1KB~2047GB，单位大小写敏感。 mem_percent 资源池可用内存占全部内存或者组用户内存使用的比例。 在多租户场景下，组用户和业务用户的mem_percent范围为1-100的整数，默认为20。 在普通场景下，普通用户的mem_percent范围为0-100的整数，默认值为0。 mem_percent和memory_limit同时指定时，只有mem_percent起作用。 io_limits 资源池每秒可触发I/O次数上限，0表示不限制I/O次数。 以万次为单位计数。 取值范围：数值型，0-2147483647 io_priority I/O利用率高达90%时，重消耗I/O作业进行I/O资源管控时关联的优先级等级。 包括三档可选：Low、Medium和High。不控制时可设置为None，默认为None。 取值范围：枚举型，可选项为：None，Low、Medium和High。 io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT、COPY FROM、CREATE TABLE AS等），单DN数据量超过500MB的复杂查询和VACUUM FULL等操作。 max_worker 只用于扩容的接口，表示扩容数据重分布时，表内插入并发度。 max_connections 最大连接数，用来限制资源池可使用的最大连接数。 所有资源池的最大连接数加起来不能超过整个gaussdb进程设置的guc参数max_connections指定的最大连接数。

STAT_USER_INDEXES 显示当前节点用户自定义普通表的索引状态信息，如表1所示。 表1 STAT_USER_INDEXES字段 名称 类型 描述 relid oid 此索引的表的OID。 indexrelid oid 索引的OID。 schemaname name 索引所在的Schema名。 relname name 索引的表名。 indexrelname name 索引名。 idx_scan bigint 该索引上执行的索引扫描次数。 idx_tup_read bigint 该索引上扫描返回的索引项数。 idx_tup_fetch bigint 使用该索引的简单索引扫描在原表中抓取的活跃行数。 last_updated timestamp with time zone 视图中该对象监控数据最后一次更新的时间。 父主题： Object

GS_ LOG ICAL_ATTRDEF GS_LOGICAL_ATTRDEF系统表记录逻辑解码需要使用的存储列的默认值。 表1 GS_LOGICAL_ATTRDEF字段 字段名称 字段类型 说明 adid oid 属性描述符的标识符。 adrelid oid 所属表的OID。 adnum smallint 属性号。 csnmin bigint 插入元组时的CSN（提交序列号）。 csnmax bigint 更新或删除元组时的CSN。 createtime timestamp with time zone 插入元组的时间戳。 originid integer 元组的来源标识符。 dbnode oid 数据库OID。 adbin pg_node_tree 默认值表达式。 adgencol "char" 是否为GENERATED列。 父主题： 逻辑解码

enable_global_syscache 参数说明：控制是否使用全局系统缓存功能。多租数据库特性（enable_mtd）需要开启该参数。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启全局系统缓存功能。 off：表示不开启全局系统缓存功能。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值，开启全局系统缓存功能可以降低系统缓存内存占用，提高并发扩展能力。若打开该参数，需要结合使用global_syscache_threshold，此时推荐使用线程池模式。若打开该参数后需要访问备机，建议设置备机wal_level级别为hot_standby以上。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

global_syscache_threshold 参数说明：全局系统缓存占用内存的最大值，使用时需要打开enable_global_syscache参数。该参数可在PDB级别设置。 参数类型：整型 参数单位：kB 取值范围：16384 ~ 1073741824 默认值：163840（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；65536（4核CPU/16G内存）。在PDB场景内，若未设置该参数，则取默认值64MB。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，设置为163840，不带单位，表示163840kB；设置为160MB，带单位，表示160MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：建议设置为热点DB个数和线程个数的最小值乘以每个DB分配的内存大小，即global_syscache_threshold = min(count(hot dbs)，count(threads)) * memofdb。 热点DB数即访问较为频繁的数据库数量。线程数在线程池模式下取线程池线程个数和后台线程个数之和，非线程池模式不需要计算这个值，直接使用热点DB数。 memofdb即平均每个db应该分配的内存，每个DB的底噪内存是2M，平均每增加一个表或者索引，增加11k内存。 设置不当的风险与影响：如果设置的值过小，会导致内存频繁淘汰，内存存在大量碎片无法回收，导致内存控制失效。当在PDB级别设置该参数时，该参数不宜设置过大，否则会影响其他租户使用预留内存，建议按照规格设置。

alarm_component 参数说明：设置用于处理告警内容的告警组件的位置。 参数类型：字符串 参数单位：无 取值范围：合法文件路径。 若前置脚本gs_preinstall中的--alarm-type参数设置为5，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为“/opt/huawei/snas/bin/snas_cm_cmd”。 若前置脚本gs_preinstall中的--alarm-type参数设置为1，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 默认值："/opt/huawei/snas/bin/snas_cm_cmd" 设置方式：该参数为CM参数，参数修改请参考表2中方式一、方式二进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

agent_heartbeat_timeout 参数说明：cm_agent检测cm_server心跳的超时时间。当cm_agent没有在超时时间内接收到cm_server的心跳信息时，将终止与cm_server的连接。 参数类型：整型 参数单位：秒（s） 取值范围：2 ~ 2147483647 默认值：5 设置方式：该参数为CM参数，参数修改请参考表2中方式一、方式二进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大和过小会导致故障检测的假阴性和假阳性。

log_dir 参数说明：log_dir决定存放cm_agent日志文件的目录。可以是绝对路径，或者是相对路径（相对于cm_agent数据目录的路径）。 参数类型：字符串 参数单位：无 取值范围：合法目录路径。 默认值：“$GAUSSLOG/cm/cm_agent”，表示在$GAUSSLOG对应的cm目录下生成cm_agent日志。 设置方式：该参数为CM参数，参数修改请参考表2中方式一进行设置，修改后需要重启cm_agent才能生效。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。