五、使用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的执行情况了。