oracle scheduler（五）使用Chains

五、使用Chains

            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

5.1.2 创建Chain Step

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

SQL> begin

DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

chain_name => 'my_chain1',

step_name => 'my_step1',

program_name => 'p_p1');

end;

/

PL/SQL procedure successfully completed.

            Chain Steps 即可以调用PROGRAM，也可以调用EVENT，甚至调用其它CHAIN(这就叫嵌套CHAIN)。

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

SQL> begin

DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

chain_name => 'my_chain1',

step_name => 'my_step2',

program_name => 'p_p2');

DBMS_SCHEDULER.DEFINE_CHAIN_STEP (

chain_name => 'my_chain1',

step_name => 'my_step3',

program_name => 'p_p3');

end;

/

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

            需要注意的是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

DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

chain_name => 'my_chain1',

condition => 'TRUE',

action => 'START my_step1',

rule_name => 'my_rule1');


DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

chain_name => 'my_chain1',

condition => 'my_step1 completed',

action => 'START my_step2',

rule_name => 'my_rule2');


DBMS_SCHEDULER.DEFINE_CHAIN_RULE (

chain_name => 'my_chain1',

condition => 'my_step2 completed',

action => 'end 0',

rule_name => 'my_rule3');

END;

/

PL/SQL procedure successfully completed.


5.1.4 运行Chains

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

SQL> BEGIN

DBMS_SCHEDULER.RUN_CHAIN (

chain_name => 'my_chain1',

start_steps => 'my_step1');

END;

/

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

DBMS_SCHEDULER.CREATE_JOB (

job_name => 'chain_job_1',

job_type => 'CHAIN',

job_action => 'my_chain1',

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

enabled => TRUE);

END;

/

PL/SQL procedure successfully completed.

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

5.2 管理Chains

5.2.1 修改Chains属性

            对于CHAIN 对象来说，能够修改的属性只有两个： evaluation_interval 和 comments，这两个参数一般情况下甚至都不会进行设置。如果你碰到了确实需要修改的情况，可以使用DBMS_SCHEDULER.SET_ATTRIBUTE 过程。例如：

SQL> select chain_name,comments from user_scheduler_chains;

CHAIN_NAME COMMENTS

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

MY_CHAIN1

SQL> exec dbms_scheduler.set_attribute('my_chain1','comments','change it for a test!');

PL/SQL procedure successfully completed.

SQL> select chain_name,comments from user_scheduler_chains;

CHAIN_NAME COMMENTS

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

MY_CHAIN1 change it for a test !

5.2.2 设置Chain Step运行属性

            修改chain step 的运行属性就不能使用dbms_scheduler.set_attribute 了，而是有专门的过程 dbms_scheduler.alter_chain 处理，该过程的定义如下：

SQL> desc dbms_scheduler.alter_chain;

Parameter Type Mode Default?

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

CHAIN_NAME VARCHAR2 IN

STEP_NAME VARCHAR2 IN

ATTRIBUTE VARCHAR2 IN

VALUE BOOLEAN IN

            前两个参数就不说了，ATTRIBUTE 参数用来指定STEP 的属性值，可设定的属性值有3 个，每个属性值都有TRUE 和FALSE 两个选项，由VALUE 参数指定：

（1）PAUSE：设置该参数值为TRUE 时，当step 运行时，其运行状态就会变更为PAUSED；

（2）SKIP：设置该参数值为TRUE 时，当step 满足运行条件时，并不是执行step 中的program，而是直接跳过，注意当SKIP 参数值设置为TRUE，并且PAUSE 参数值也被设置为TRUE，那么将会以PAUSE 的状态优先；

（3）RESTART_ON_RECOVERY：设置该参数值为TRUE 时，如果由于数据库shutdown 导致step 被停止，那么当下次数据库启动时，step 会自动重新运行。

            DBMS_SCHEDULER.ALTER_CHAIN 过程修改Chain Step 属性后，只有当下次运行时才会生效，如果要修改当前运行中Chain Step 的属性，也有一个专门的过程DBMS_SCHEDULER.ALTER_RUNNING_CHAIN 进行处理，该过程语法与DBMS_SCHEDULER.ALTER_CHAIN 一模一样。

5.2.3 删除Chain Rules

            Chain Rules 没有对应的修改方法，如果要修改某个Chain 的rule，只能首先删除不适当的rule，然后重新添加新rule(所谓添加，其实就是再重新定义一个rule)。

            删除Chain Rule 有专门的过程DBMS_SCHEDULER.DROP_CHAIN_RULE，该过程语法如下：

SQL> desc dbms_scheduler.drop_chain_rule;

Parameter Type Mode Default?

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

CHAIN_NAME VARCHAR2 IN

RULE_NAME VARCHAR2 IN

FORCE BOOLEAN IN Y

举个简单的示例，比如删除前面定义的my_rule3，执行过程如下：

SQL> exec dbms_scheduler.drop_chain_rule('my_chain1','my_rule3',true);

PL/SQL procedure successfully completed.

 
5.2.4 删除Chain Steps

            删除Chain Step 也有专门的过程dbms_scheduler.drop_chain_step 进行处理，该过程语法如下：

SQL> desc dbms_scheduler.drop_chain_step;

Parameter Type Mode Default?

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

CHAIN_NAME VARCHAR2 IN

STEP_NAME VARCHAR2 IN

FORCE BOOLEAN IN Y

 
例如，删除之前定义的my_step3，执行过程如下：

SQL> exec dbms_scheduler.drop_chain_step('my_chain1','my_step3',true);

PL/SQL procedure successfully completed.


5.2.5 删除Chains

            如果要删除Chain 那就更简单了，执行dbms_scheduler.drop_chain 过程即可，例如：

SQL> exec dbms_scheduler.drop_chain('my_chain1',true);

PL/SQL procedure successfully completed.


            注意，执行drop_chain 时，如果不指定force 参数为TRUE，那么默认情况下ORACLE 会首先检查要删除的CHAIN 是否还有被依赖的对象，如果存在的话，会报ORA-27479 错误，提示仍然有依赖的对象(所谓依赖的对象就是指，该chain 仍然存在chain_step 或chain_rule 之类)，因此无法直接删除。

这种情况下解决方案有两种：

（1）手动删除所有相关的chain_step 和chain_rule，然后再执行chain 的删除，

（2）附加force 参数并指定参数值为true，这样ORACLE 就会自动替你清除所有依赖的对象了。

转自：http://blog.csdn.net/tianlesoftware/article/details/4715218