全面学习ORACLE Scheduler特性(9)创建Chains

五、使用Chains

　　今天要来认识一位新同学：CHAIN(注意不要敲成CHINA)。CHAIN可以被视做一组Programs的复合，举个简单的例子：运行PROGRAM:A以及PROGRAM:B，如果成功的话继续运行PROGRAM:C，否则的话运行PROGRAM:D。Programs:A、B、C、D以及执行的逻辑关系就构成了一个最简单的CHAIN。

　　关于CHAIN的管理操作比较多，比如创建/删除/修改Chains，添加/修改/删除Chain Steps等等。

5.1  创建Chains

5.1.1  创建CHAIN对象

　　创建CHAIN使用DBMS_SCHEDULER.CREATE_CHAIN过程，这个过程调用非常简单，因为需要指定的参数极少，该过程的定义如下：

SQL> desc dbms_scheduler.create_chain;

Parameter           Type                   Mode Default?

------------------- ---------------------- ---- --------

CHAIN_NAME          VARCHAR2               IN

RULE_SET_NAME       VARCHAR2               IN   Y

EVALUATION_INTERVAL INTERVAL DAY TO SECOND IN   Y

COMMENTS            VARCHAR2               IN   Y

　　在创建时，甚至可以简单到只指定一个CHAIN的名称，其它均为空即可，例如：

SQL> exec dbms_scheduler.create_chain('my_chain1');

PL/SQL procedure successfully completed.

　　定义好的Chains，可以通过*_SCHEDULER_CHAINS视图查看，例如：

SQL> select chain_name from user_scheduler_chains;

CHAIN_NAME

------------------------------

MY_CHAIN1

　　注意，不是说创建了CHAIN就齐活，只有一个CHAIN对象ORACLE还是啥也干不了(当然啦，相信从上面执行的创建语句大家也看出来了)，CHAIN对象创建之后，要做的工作其实才刚刚开始。其后，还需要定义Chain Steps以及Chain rules。

5.1.2  创建Chain Step

　　Chain Steps 就是用来指定CHAIN执行的操作及执行步骤，创建CHAIN STEP是通过DBMS_SCHEDULER.DEFINE_CHAIN_STEP过程进行，例如，为刚刚创建的my_chain1添加一个step，执行操作如下：

SQL> begin

2  DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

3     chain_name      =>  'my_chain1',

4     step_name       =>  'my_step1',

5     program_name    =>  'p_p1');

6  end;

7  /

PL/SQL procedure successfully completed.

　　Chain Steps 即可以调用PROGRAM(注意是program，不是procedure，当然program中可以定义执行procedure)，也可以调用EVENT，甚至调用其它CHAIN(这就叫嵌套CHAIN)。

　　下面接着为my_chain1添加两个step，操作如下：

SQL> begin

2  DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

3     chain_name      =>  'my_chain1',

4     step_name       =>  'my_step2',

5     program_name    =>  'p_p2');

6  DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

7     chain_name      =>  'my_chain1',

8     step_name       =>  'my_step3',

9     program_name    =>  'p_p3');

10  end;

11  /

PL/SQL procedure successfully completed.

　　要查询定义的Chain Steps，则是通过*_SCHEDULER_CHAIN_STEPS视图，例如：

SQL> select chain_name,step_name,program_name from user_scheduler_chain_steps;

CHAIN_NAME           STEP_NAME            PROGRAM_NAME

-------------------- -------------------- --------------------

MY_CHAIN1            MY_STEP1             P_P1

MY_CHAIN1            MY_STEP2             P_P2

MY_CHAIN1            MY_STEP3             P_P3

5.1.3  创建Chain Rule

　　接下来，要为CHAIN的运行定义规则。定义规则是使用DBMS_SCHEDULER.DEFINE_CHAIN_RULE过程，Chain Rules依赖于Chain Steps，每个CHAIN RULE都拥有condition和action属性，当满足condition时则执行action中指定的step。

　　DBMS_SCHEDULER.DEFINE_CHAIN_RULE 过程的语法如下：

SQL> desc dbms_scheduler.define_chain_rule;

Parameter  Type     Mode Default?

---------- -------- ---- --------

CHAIN_NAME VARCHAR2 IN

CONDITION  VARCHAR2 IN

ACTION     VARCHAR2 IN

RULE_NAME  VARCHAR2 IN   Y

COMMENTS   VARCHAR2 IN   Y

　　CHAIN_NAME 就不说了，需要注意的是CONDITION和ACTION两个参数。在为condition参数指定值时，其语法看起来稍稍复杂一些，或者说是灵活，condition参数值支持下列的语法形式：

• TRUE
• FALSE
• stepname [NOT] SUCCEEDED
• stepname [NOT] FAILED
• stepname [NOT] STOPPED
• stepname [NOT] COMPLETED
• stepname ERROR_CODE IN (integer, integer, integer ...)
• stepname ERROR_CODE NOT IN (integer, integer, integer ...)
• stepname ERROR_CODE = integer
• stepname ERROR_CODE != integer
• stepname ERROR_CODE <> integer
• stepname ERROR_CODE > integer
• stepname ERROR_CODE >= integer
• stepname ERROR_CODE < integer
• stepname ERROR_CODE <= integer

　　甚至于，还可以制定成下列逻辑语法：

• expression AND expression
• expression OR expression
• NOT (expression)

　　比如说，我们希望条件为step1成功运行，那么可以指定condition参数值如下：

'step1 completed'

　　Action 参数相对简单一些，这个参数用来指定当满足condition参数时，CHAIN执行的操作。

　　例如，创建CHAIN RULE，首先执行my_step1，如果my_step1成功执行的话，就继续执行my_step2，如果my_step2也成功执行的话，则结束该CHAIN，创建脚本如下：

SQL> BEGIN

2  DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

3     chain_name   =>   'my_chain1',

4     condition    =>   'TRUE',

5     action       =>   'START my_step1',

6     rule_name    =>   'my_rule1');

7  DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

8     chain_name   =>   'my_chain1',

9     condition    =>   'my_step1 completed',

10     action       =>   'START my_step2',

11     rule_name    =>   'my_rule2');

12  DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

13     chain_name   =>   'my_chain1',

14     condition    =>   'my_step2 completed',

15     action       =>   'end 0',

16     rule_name    =>   'my_rule3');

17  END;

18  /

PL/SQL procedure successfully completed.

5.1.4  运行Chains

　　最后，来运行一下创建的my_chain1吧，手动运行CHAIN是通过DBMS_SCHEDULER.RUN_CHAIN过程，例如：

SQL> BEGIN

2  DBMS_SCHEDULER.RUN_CHAIN (

3     chain_name    =>  'my_chain1',

4     start_steps   =>  'my_step1');

5  END;

6  /

PL/SQL procedure successfully completed.

　　语句执行成功，下面需要查看一下执行的结果。我们之前定义的p_p1等program对象，实际上是调用procedure，向一个指定表jss_t2中插入记录，这里直接查询一下该表，就知道执行情况了(在此之前，jss_t2表为空)：

SQL> select * from jss_t2;

TP                             DT

------------------------------ ------------

p_p1 inserted                  03-SEP-09

p_p2 inserted                  03-SEP-09

　　你看，jss_t2表中有了两条记录，对应前面设置的CHAIN RULE，说明my_step1和my_step2均已正确执行。

提示：Chains在执行前，必须被置于enabled状态，默认情况下刚刚创建的CHAIN都是disabled状态，要修改Chains的状态，还是通过DBMS_SCHEDULER.ENABLE和DBMS_SCHEDULER.DISABLE两过程，这里就不演示了。

　　手动执行的CHAIN的话没有系统级的日志记录，因此如果希望看到详细执行情况的话，建议创建job来执行CHAIN，例如：

SQL> BEGIN

2  DBMS_SCHEDULER.CREATE_JOB (

3     job_name        => 'chain_job_1',

4     job_type        => 'CHAIN',

5     job_action      => 'my_chain1',

6     repeat_interval => 'freq=daily;interval=1',

7     enabled         => TRUE);

8  END;

9  /

PL/SQL procedure successfully completed.

　　然后，dba就可以通过定期观察*_scheduler_job_run_details视图来确认chain的执行情况了。