五、使用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的名称,其它均为空即可,例如:
定义好的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参数值如下:
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的执行情况了。
|