OceanBase 執(zhí)行計劃管理

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

SPM 包含如下過程：

1. 計劃捕獲。

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

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

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

3. 計劃選擇。

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

SPM 的系統(tǒng)變量

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

設(shè)置說明如下：

DBMS_SPM

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

LOAD_PLANS_FROM_CURSOR_CACHE

LOAD_PLANS_FROM_CURSOR_CACHE 用于將 plan cache 中執(zhí)行計劃對應(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ù)解釋如下：

如下示例所示，將某個 Plan Baseline 固化后該 SQL 僅使用該計劃：

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 用于刪掉某個 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;
/