更新时间:2024-06-03 GMT+08:00

SPM计划管理

SPM_ENABLE_PLAN_CAPTURE

参数说明此参数用来控制SPM计划捕获功能的计划捕获模式。

参数类型:枚举型

参数单位:

取值范围off、auto、manual、store

  • off:表示不开启计划捕获功能。
  • auto:表示开启自动计划捕获功能。在这种模式下,SQL计划被捕获的前置条件是SQL被执行两次及以上。
  • manual:表示开启手动计划捕获功能。在这种模式下,SQL计划被捕获的前置条件不需要满足SQL被执行两次及以上。
  • store: 基于auto选项的行为,所有计划的状态都捕获为UNACC状态。

默认值off

设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。

设置建议:

升级期间,该参数是否开启,都不会捕获新的计划的outline。升级期间可能会发生升级回滚现象,当存储了新产生的outline,升级回滚后可能会存在outline版本兼容性的问题。

SPM_ENABLE_PLAN_SELECTION

参数说明此参数用来控制是否启用SPM计划选择功能。

参数类型:布尔型

参数单位:

取值范围

  • on:表示启用计划选择功能。
  • off:表示关闭计划选择功能。

默认值off

设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。

设置建议:

SPM_PLAN_CAPTURE_FILTER

参数说明:此参数用来指定要捕获的数据库与Schema。

参数类型:字符串

参数单位:

取值范围:最多捕获10000个Schema,计数包括重复Schema。

参数的格式为:“$db1_oid:$schema1_oid, $db2_oid:$schema2_oid..”,例如符合该格式的一组参数“33245:56432,44321:12332,55432:65432”表示:

  • 33245:56432表示捕获DB oid为33245且schema oid为56432下的SQL计划。
  • 44321:12332表示捕获DB oid为44321且schema oid为12332下的SQL计划。
  • 55432:65432表示捕获DB oid为55432且schema oid为65432下的SQL计划。

默认值:空字符串,表示SPM的计划捕获和计划选择功能包含所有Schema。

设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。

设置建议:

SPM_PLAN_GLOBAL_CACHED_SIZE

参数说明:指定SPM global plan cache的大小。

参数类型整型

参数单位:KB

取值范围:10240 ~ 20971520

默认值:1048576

设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。

设置建议:建议在压力大的场景中增加数据库节点中此参数配置。

SPM_PLAN_SESSION_CACHED_SIZE

参数说明:指定SPM session plan cache的大小。

参数类型整型

参数单位KB

取值范围:1~ 1048576

默认值:1024

设置方式:该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。

设置建议:建议在压力大的场景中增加数据库节点中此参数配置。

SPM_PLAN_CAPTURE_MAX_PLANNUM

参数说明:指定单个数据库最大落盘计划的数量。

参数类型:整型

参数单位:

取值范围:1 ~ 1000000

默认值:10000

设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。

设置建议:

SPM_PLAN_RETENTION_DAYS

参数说明:指定不使用的计划在磁盘上的预留时间。

参数类型:整型

参数单位:

取值范围:1~ 1095

默认值:365

设置方式:该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。

设置建议:

SPM_ENABLE_LOG_DETAIL

参数说明在使用SPM的过程中,控制是否启用notice SPM关键执行流程。该参数通常和如下两个参数的设置配合使用,用于在gsql中查看SPM的执行过程:client_min_messages=notice;logging_module='on(SPM_KEY_FLOW)'。

参数类型:布尔型

参数单位:

取值范围

  • on:表示启用。
  • off:表示关闭。

默认值off

设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。

设置建议:

SPM_ENABLE_BASELINE_CLEANUP

参数说明是否启用baseline定时清理功能。

参数类型:布尔型

参数单位:

取值范围

  • on:表示启用baseline定时清理功能。
  • off:表示关闭baseline定时清理功能。

默认值on

设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。

设置建议: