Oracle Outline

1)outline
1@@@@information
@@@
select * from dba_outlines;
select * from dba_outline_hints;
select * from dba_view where view_name='DBA_OUTLINES'
select * from outln.ol$;     @@@base table
select * from outln.ol$hints;  @@@base table

@@@
@@@referencing
http://www.oracle-base.com/articles/misc/outlines.php


2@@@@a basic example for outline by scott
preview:
<1>grant privilege to scott for lab.
<2>create a outline "emp_dept" to a category "scott_outlines"
   ~~create a outline using general way.
<3>create a second outline in the same category.
   ~~use "dbms_outln.create_outline" to create outline for that sql statement.
<4>check the outline your created.
   ~~user_outlines
   ~~user_outlines_hints
<5>begin to using outline for these sql statement.
<6>drop outline
<7>summary

@@@
@@@<1>grant privilege to scott for lab.
@@@
SQL> conn / as sysdba;
SQL> grant create any outline to scott;
SQL> grant resource to scott;    
SQL> grant execute_catalog_role to scott;
SQL> alter user scott identified by scott account unlock;
SQL> ALTER SYSTEM SET create_stored_outlines=FALSE;
@@@Outlines can be created automatically by Oracle or manually
@@@for specific statements.


@@@
@@@<2>create a outline "emp_dept" to a category "scott_outlines"
@@@
@@@create a outline using general purpose
@@@one category map multi-oultine.
SQL> conn scott/scott
SQL> ed
  1  CREATE OUTLINE  emp_dept
  2  FOR CATEGORY scott_outlines
  3  ON
  4  SELECT e.empno, e.ename, d.dname
  5  FROM  emp e, dept d
  6* WHERE e.deptno = d.deptno
SQL> /

@@@
@@@check using "user_outlines" 
SQL> col name format a30
SQL> ed
  1  SELECT name, category, sql_text
  2  FROM user_outlines
  3* WHERE category='SCOTT_OUTLINES'
SQL> /
NAME                   CATEGORY
------------------------------ -----------------
SQL_TEXT
----------------------------------------------
EMP_DEPT               SCOTT_OUTLINES
SELECT e.empno, e.ename, d.dname
FROM  emp e, dept d
WHERE e.deptno = d.deptno

@@@
@@@check using "user_outline_hints"
SQL> set linesize 200
SQL> ed
  1  SELECT node, stage, join_pos, hint
  2  FROM user_outline_hints
  3* WHERE name='EMP_DEPT'
SQL> /
      NODE    STAGE    JOIN_POS HINT
---------- ---------- ---------- ----------------------------------------------
     1        1           0 USE_NL(@"SEL$1" "D"@"SEL$1")
     1        1           0 LEADING(@"SEL$1" "E"@"SEL$1" "D"@"SEL$1")
     1        1           2 INDEX(@"SEL$1" "D"@"SEL$1" ("DEPT"."DEPTNO"))
     1        1           1 FULL(@"SEL$1" "E"@"SEL$1")
     1        1           0 OUTLINE_LEAF(@"SEL$1")
     1        1           0 ALL_ROWS
     1        1           0 OPTIMIZER_FEATURES_ENABLE('10.2.0.1')
     1        1           0 IGNORE_OPTIM_EMBEDDED_HINTS
8 rows selected.


@@@
@@@<3>create a second outline in the same category.
@@@
@@@create the outline for this sql statement.
SQL> ed
  1  SELECT e.empno, e.ename, d.dname, e.job
  2  FROM emp e, dept d
  3  WHERE e.deptno = d.deptno
  4*   AND d.dname = 'SALES'
SQL> /
     EMPNO ENAME      DNAME         JOB
---------- ---------- -------------- ---------
      7499 ALLEN      SALES         SALESMAN
      7521 WARD       SALES         SALESMAN
      7654 MARTIN     SALES         SALESMAN
      7698 BLAKE      SALES         MANAGER
      7844 TURNER     SALES         SALESMAN
      7900 JAMES      SALES         CLERK

@@@
SQL> ed
  1  SELECT hash_value, child_number, sql_text
  2  FROM v$sql
  3* WHERE sql_text LIKE 'SELECT e.empno, e.ename, d.dname, e.job%'
SQL> /
HASH_VALUE CHILD_NUMBER
---------- ------------
SQL_TEXT
--------------------------------------------------------------------------------
3985699533          0
SELECT e.empno, e.ename, d.dname, e.job FROM emp e, dept d WHERE e.deptno = d.de
ptno   AND d.dname = 'SALES'


@@@
@@@use "dbms_outln.create_outline"  to create outline for that sql statement.
@@@according to the hash_value
SQL> ed
  1  BEGIN
  2   DBMS_OUTLN.create_outline(
  3    hash_value => 3985699533,
  4    child_number => 0,
  5    category => 'SCOTT_OUTLINES');
  6* END;
SQL> /
PL/SQL procedure successfully completed.


@@@
@@@<4>check the outline your created.
@@@
@@@check the outline using "user_outlines"
SQL> col name format a30
SQL> ed        
  1  SELECT name, category, sql_text
  2  FROM user_outlines
  3* WHERE category = 'SCOTT_OUTLINES'
SQL> /
NAME                   CATEGORY
------------------------------ ------------------------------
SQL_TEXT
--------------------------------------------------------------------------------
EMP_DEPT               SCOTT_OUTLINES
SELECT e.empno, e.ename, d.dname
FROM  emp e, dept d
WHERE e.deptno = d.deptno

SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES
SELECT e.empno, e.ename, d.dname, e.job
FROM emp e, dept d
WHERE e.deptno = d.de

@@@
@@@check the outline using "user_outlines_hints"
SQL> col hint format a50
SQL> ed
  1  SELECT node, stage, join_pos, hint
  2  FROM user_outline_hints
  3* WHERE name='SYS_OUTLINE_12070714433606601'
SQL> /
      NODE    STAGE    JOIN_POS HINT
---------- ---------- ---------- --------------------------------------------------
     1        1           0 USE_NL(@"SEL$1" "D"@"SEL$1")
     1        1           0 LEADING(@"SEL$1" "E"@"SEL$1" "D"@"SEL$1")
     1        1           2 INDEX(@"SEL$1" "D"@"SEL$1" ("DEPT"."DEPTNO"))
     1        1           1 FULL(@"SEL$1" "E"@"SEL$1")
     1        1           0 OUTLINE_LEAF(@"SEL$1")
     1        1           0 ALL_ROWS
     1        1           0 OPTIMIZER_FEATURES_ENABLE('10.2.0.1')
     1        1           0 IGNORE_OPTIM_EMBEDDED_HINTS
8 rows selected.

@@@
SQL> SELECT name, category , used FROM user_outlines;
NAME                   CATEGORY               USED
------------------------------ ------------------------------ ------
EMP_DEPT               SCOTT_OUTLINES              UNUSED
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES              UNUSED

@@@
SQL> SELECT e.empno, e.ename , d.dname FROM emp e, dept d WHERE e.deptno=d.deptno;
SQL> SELECT e.empno, e.ename, d.dname, e.job FROM emp e, dept d
     WHERE e.deptno = d.deptno AND d.dname = 'SALES';

@@@
SQL> SELECT name, category , used FROM user_outlines;
NAME                   CATEGORY               USED
------------------------------ ------------------------------ ------
EMP_DEPT               SCOTT_OUTLINES              UNUSED
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES              UNUSED


@@@
@@@<5>begin to using outline for these sql statement.
@@@
@@@open the execute plan to check
SQL> alter session set query_rewrite_enabled = true;
SQL> alter session set use_stored_outlines=SCOTT_OUTLINES;
SQL> set autot on
SQL> SELECT e.empno, e.ename , d.dname FROM emp e, dept d WHERE e.deptno=d.deptno;
Note
-----
   - outline "EMP_DEPT" used for this statement

SQL> SELECT e.empno, e.ename, d.dname, e.job FROM emp e, dept d
     WHERE e.deptno = d.deptno AND d.dname = 'SALES';
Note
-----
   - outline "SYS_OUTLINE_12070714433606601" used for this statement

@@@
SQL> SELECT name, category , used FROM user_outlines;
NAME                   CATEGORY               USED
------------------------------ ------------------------------ ------
EMP_DEPT               SCOTT_OUTLINES              USED
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES              USED


@@@
@@@<6>drop outline
@@@
SQL> exec dbms_outln.drop_by_cat(cat=> 'SCOTT_OUTLINE');
PL/SQL procedure successfully completed.


@@@
@@@<7>summary
@@@
keep one execution plan with runing a sql statement using current statistic,
when you set "alter session/system set use_stored_outline=<category_name>"
parameter, you would use privous excution and ignore current statistic.


3@@@@clone outline
@@@may be it is replacing.
SQL> select name,category from user_outlines;
NAME                   CATEGORY
------------------------------ ------------------------------
EMP_DEPT               SCOTT_OUTLINES
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES

SQL> CREATE OR REPLACE OUTLINE clone_outline01
     FROM emp_dept
     FOR CATEGORY scott_outlines;
Outline created.

SQL> select name,category from user_outlines;
NAME                   CATEGORY
------------------------------ ------------------------------
CLONE_OUTLINE01            SCOTT_OUTLINES
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES


4@@@@private outline
@@@
SQL> CREATE PRIVATE OUTLINE private_dev01 FROM CLONE_OUTLINE01;
Outline created.

SQL> select name,category from user_outlines;
NAME                   CATEGORY
------------------------------ ------------------------------
CLONE_OUTLINE01            SCOTT_OUTLINES
SYS_OUTLINE_12070714433606601  SCOTT_OUTLINES

SQL> CREATE OR REPLACE  PRIVATE OUTLINE private_dev02 FROM clone_outline01;
Outline created.

@@@this is a implict parameter.
@@@true => use private outline
@@@false => use public outline
SQL> alter session set use_private_outlines=true;
Session altered.


5@@@@outline editing
@@@use /*+ xxxxx */ hint to leading the excution plan in the outline
Editable Attributes
• Join order
• Join methods
• Access methods
• Distributed execution plans
• Distribution methods for parallel query execution
• Query rewrite
• View and subquery merging
@@@to be continue......................