OceanBase 執(zhí)行計(jì)劃管理

SPM 基于 SQL Plan Baseline 實(shí)現(xiàn)，SQL Plan Baseline 是執(zhí)行計(jì)劃的一個(gè)基線，持久化存儲(chǔ)已經(jīng)驗(yàn)證過的執(zhí)行計(jì)劃的信息（outline_data 等信息），每個(gè)執(zhí)行計(jì)劃可對(duì)應(yīng)一個(gè) Plan Baseline，通過該 Plan Baseline 可復(fù)現(xiàn)一個(gè)執(zhí)行計(jì)劃。

SPM 包含如下過程：

1. 計(jì)劃捕獲。

   對(duì)于新生成的計(jì)劃，如果 SQL Plan Baseline 為空，則直接加入 SQL Plan Baseline，否則通過演進(jìn)驗(yàn)證新生成計(jì)劃比 SQL Plan Baseline 中計(jì)劃性能更優(yōu)后加入 SQL Plan Baseline，并刪除舊的 Plan Baseline。

2. 計(jì)劃演進(jìn)。

   相同 SQL 新捕獲的計(jì)劃如果和 SQL Plan Baseline 中計(jì)劃不一樣，則通過流量灰度驗(yàn)證新計(jì)劃性能是否比以前驗(yàn)證過的計(jì)劃更優(yōu)。如果更優(yōu)，則將新計(jì)劃加入 SQL Plan Baseline，并執(zhí)行新計(jì)劃，否則仍使用舊計(jì)劃。

3. 計(jì)劃選擇。

   在優(yōu)化器新生成計(jì)劃時(shí)，會(huì)查看 SQL Plan Baseline 是否有已驗(yàn)證的計(jì)劃，如果有，則優(yōu)先使用已驗(yàn)證計(jì)劃，新計(jì)劃需要通過演進(jìn)驗(yàn)證后再使用。

SPM 的系統(tǒng)變量

SPM 使用如下系統(tǒng)變量和系統(tǒng)包對(duì)執(zhí)行計(jì)劃進(jìn)行管理：

設(shè)置說明如下：

DBMS_SPM

DBMS_SPM 是用于操作 SPM 的命令包，可支持加載、更改以及刪除 Plan Baseline 信息。

LOAD_PLANS_FROM_CURSOR_CACHE

LOAD_PLANS_FROM_CURSOR_CACHE 用于將 plan cache 中執(zhí)行計(jì)劃對(duì)應(yīng)的 Plan Baseline 信息加載到 _ _all_tenant_plan_baseline 表中。語法如下：

DBMS_SPM.LOAD_PLANS_FROM_CURSOR_CACHE (
   sql_id            IN  VARCHAR2,
   plan_hash_value   IN  NUMBER   := NULL,
   fixed             IN  VARCHAR2 := 'NO',
   enabled           IN  VARCHAR2 := 'YES')
 RETURN PLS_INTEGER;

參數(shù)解釋如下：

如下例所示：

DECLARE
  v_load_plans number;
BEGIN
  v_load_plans := DBMS_SPM.LOAD_PLANS_FROM_CURSOR_CACHE(
     sql_id => '529F6E6454EF579C7CC265D1F6131D70',
     plan_hash_value => 13388268709115914355);
END;
/

ALTER_SQL_PLAN_BASELINE

ALTER_SQL_PLAN_BASELINE 用于修改 Plan Baseline 中某些屬性。語法如下：

DBMS_SPM.ALTER_SQL_PLAN_BASELINE ( 
   sql_handle        IN VARCHAR2 := NULL,
   plan_name         IN VARCHAR2 := NULL,
   attribute_name    IN VARCHAR2,
   attribute_value   IN VARCHAR2)
 RETURN PLS_INTEGER;

參數(shù)解釋如下：

如下示例所示，將某個(gè) Plan Baseline 固化后該 SQL 僅使用該計(jì)劃：

DECLARE
  v_alter_plans number;
BEGIN
  v_alter_plans := DBMS_SPM.ALTER_SQL_PLAN_BASELINE(
     sql_handle => '529F6E6454EF579C7CC265D1F6131D70',
     plan_name => '3388268709115914355',
     attribute_name => 'fixed',
     attribute_value => 'YES' );
END;
/

DROP_SQL_PLAN_BASELINE

DROP_SQL_PLAN_BASELINE 用于刪掉某個(gè) Plan Baseline。語法如下：

DBMS_SPM.DROP_SQL_PLAN_BASELINE (
   sql_handle     IN VARCHAR2 := NULL,
   plan_name      IN VARCHAR2 := NULL)
RETURN PLS_INTEGER;

示例如下：

DECLARE
  v_drop_plans number;
BEGIN
  v_drop_plans := DBMS_SPM.DROP_SQL_PLAN_BASELINE(
     sql_handle => '529F6E6454EF579C7CC265D1F6131D70',
     plan_name => '3388268709115914355' );
END;
/