【OUTLINE】使用Oracle Outline技术暂时锁定SQL的执行计划

  记录一下关于outline的使用方法，供参考。

1.初始化环境
1）创建用户secooler，并授予适当权限，注意，用户需要具有create any outline权限
SYS@PROD> create user secooler identified by secooler;

User created.

SYS@PROD> grant connect,resource to secooler;

Grant succeeded.

SYS@PROD> grant create any outline,alter any outline to secooler;

Grant succeeded.

2）在secooler用户中创建表T
SYS@PROD> conn secooler/secooler
Connected.
SECOOLER@PROD> create table t as select * from all_objects;

Table created.

SECOOLER@PROD> select count(*) from t;

  COUNT(*)
———-
      4448

2.创建outline
1）解锁outln用户
SECOOLER@PROD> conn / as sysdba
Connected.
SYS@PROD> alter user outln identified by outln account unlock;

User altered.

2）创建一个outline，取名叫做t_outln1，指定它的category名字为CATEGORY_T
SYS@PROD> conn secooler/secooler
Connected.
SECOOLER@PROD> create outline t_outln1 for category CATEGORY_T on select * from t where OBJECT_ID=258;

Outline created.

3）此时outln用户下的三张表OL$、OL$HINTS和OL$NODES中便会记录与此次操作的相关信息。执行计划会记录在OL$HINTS中。
SECOOLER@PROD> conn outln/outln
Connected.
OUTLN@PROD> select hint_text from ol$hints where ol_name = ‘T_OUTLN1’ order by hint#;

HINT_TEXT
——————————————————————————–
FULL(@”SEL$1″ “T”@”SEL$1”)
OUTLINE_LEAF(@”SEL$1″)
ALL_ROWS
OPTIMIZER_FEATURES_ENABLE(‘10.2.0.1’)
IGNORE_OPTIM_EMBEDDED_HINTS

4）比对一下对应的执行计划
OUTLN@PROD> conn secooler/secooler
Connected.
SECOOLER@PROD> set autotrace traceonly explain;
SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 1601196873

Note
—–
   – dynamic sampling used for this statement

这里记录了一个全表扫描的执行计划。

5）关于创建的outline基本信息也可以通过dba_outlines视图进行查询
SECOOLER@PROD> conn / as sysdba
Connected.
SYS@PROD> select NAME,OWNER,CATEGORY,SQL_TEXT from dba_outlines;

NAME                           OWNER
—————————— ——————————
CATEGORY
——————————
SQL_TEXT
————————————————————-
T_OUTLN1                       SECOOLER
CATEGORY_T
select * from t where OBJECT_ID=258

3.使用outline
1）为了对比，我们创建索引，改变SQL语句的执行计划
（1）在T表的X字段创建索引
SYS@PROD> conn secooler/secooler
Connected.
SECOOLER@PROD> create index i_t on t(object_id);

Index created.

（2）查看此时SQL的执行计划
SECOOLER@PROD> set lines 200
SECOOLER@PROD> set autotrace traceonly explain;
SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 2928007915

Note
—–
   – dynamic sampling used for this statement

从执行计划上可以看到此时该SQL使用到了索引，没有进行全表扫面。

2）强制SQL使用ontline中记录的执行计划
（1）设置会话使用category为CATEGORY_T的outline
SECOOLER@PROD> alter session set use_stored_outlines=CATEGORY_T;

Session altered.

（2）再次查看SQL语句的执行计划
SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 1601196873

Note
—–
   – outline “T_OUTLN1” used for this statement

从最后的注释上我们已经可以看到，此时SQL语句执行过程中使用的是outln中记录的执行计划。SQL在获取数据的时候走的是全表扫描。

3）消除ontline对SQL语句的影响
（1）第一种方法是调整use_stored_outlines参数为false
SECOOLER@PROD> alter session set use_stored_outlines=false;

Session altered.

SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 2928007915

Note
—–
   – dynamic sampling used for this statement

（2）第二种方法是停用具体的outline
这种方法可以在use_stored_outlines参数起作用的前提下停用具体的outline。
SECOOLER@PROD> alter session set use_stored_outlines=CATEGORY_T;

Session altered.

SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 1601196873

Note
—–
   – outline “T_OUTLN1” used for this statement

SECOOLER@PROD> alter outline t_outln1 disable;

Outline altered.

SECOOLER@PROD> select * from t where OBJECT_ID=258;

Execution Plan
———————————————————-
Plan hash value: 2928007915

Note
—–
   – dynamic sampling used for this statement

此时ontline T_OUTLN1已经被停用。

4.清除outline
我们在10g环境下可以使用dbms_outln.drop_by_cat完成清空具体category的目的。
SECOOLER@PROD> conn outln/outln
Connected.
OUTLN@PROD> select hint_text from ol$hints where ol_name = ‘T_OUTLN1’ order by hint#;

HINT_TEXT
——————————————————
FULL(@”SEL$1″ “T”@”SEL$1”)
OUTLINE_LEAF(@”SEL$1″)
ALL_ROWS
OPTIMIZER_FEATURES_ENABLE(‘10.2.0.1’)
IGNORE_OPTIM_EMBEDDED_HINTS

OUTLN@PROD> exec dbms_outln.drop_by_cat(‘CATEGORY_T’);

PL/SQL procedure successfully completed.

OUTLN@PROD> select hint_text from ol$hints where ol_name = ‘T_OUTLN1’ order by hint#;

no rows selected

5.关于USE_STORED_OUTLINES参数的说明
USE_STORED_OUTLINES参数不像一般的参数可以在参数文件中进行设定，但我们可以使用常规的方法对其进行修改。
ALTER SESSION SET USE_STORED_OUTLINES = TRUE | FALSE | category;
ALTER SYSTEM SET USE_STORED_OUTLINES = TRUE | FALSE | category;

6.小结
  通过文中的描述，大家应该对Oracle Outline技术有一个比较详细的了解。在CBO优化模式下，很有可能遇到执行计划不稳定及不准确的情况。在这种场景下我们可以考虑使用这项技术暂时规避执行计划变化带来的性能问题。

Good luck.

secooler
10.09.08

— The End —