一、使用Jobs
所谓JOBS,其实就是Scheduler管理的一个(或多个)任务的执行调度。可以查看所有的Scheduler创建的JOB@H_301_7@
select * from dba_scheduler_jobs
@H_301_7@
1.1 创建Jobs
通过DBMS_SCHEDULER包来创建Jobs,是使用其CREATE_JOB过程。在创建Job时,用户可以指定要执行的任务,调度信息(啥时候执行,执行周期,终止日期等)以及其它一些任务相关的属性。CREATE_JOB过程调用还是比较简单的,例如:@H_301_7@
事实上,有权限的话,用户也可以创建其它SCHEMA下的JOB,只需要在指定JOB_NAME时,按照schema.job_name的格式即可。注意哟,这种情况下创建的JOB,其CREATED与OWNER有可能并不相同的哟。@H_301_7@
当使用CREATE_JOB过程创建JOB时,可指定的参数值很多,只不过多数情况下用户仅指定部分参数即可满足需求。@H_301_7@
其中,上例中指定的参数,分别代表的含义如下:@H_301_7@
- JOB_NAME :指定任务的名称,必选值,注意要确保指定的名称唯一。
- JOB_TYPE :任务执行的操作类型,必选值,有下列几个可选值:
- JOB_ACTION :任务执行的操作,必选值,应与JOB_TYPE类型中指定的参数相匹配。
比如说对于PL/sql匿名块,此处就可以放置PL/sql块的具体代表,类似DECLARE..BEGIN..END这类;如果是ORACLE过程,那么此处应该指定具体的过程名,注意由于任务执行,即使过程中有OUT之类参数,实际执行时也不会有输出的。@H_301_7@
- START_DATE :指定任务初次执行的时间,本参数可为空,当为空时,表示任务立刻执行,效果等同于指定该参数值为SYSDATE。
- REPEAT_INTERVAL :指定任务执行的频率,比如多长时间会被触发再次执行。本参数也可以为空,如果为空的话,就表示当前设定的任务只执行一次。 REPEAT_INTERVAL参数需要好好说说,因为这一参数与标准JOB中的INTERVAL参数有很大区别,相比之 下,REPEAT_INTERVAL参数的语法结构要复杂的多。其中最重要的是FREQ和INTERVAL两个关键字。
- FREQ 关键字用来指定间隔的时间周期,可选参数有:YEARLY,MONTHLY,WEEKLY,DAILY,HOURLY,MINUTELY,andSECONDLY,分别表示年、月、周、日、时、分、秒等单位。
- INTERVAL 关键字用来指定间隔的频繁,可指定的值的范围从1-99。
例如:REPEAT_INTERVAL=>'FREQ=DAILY;INTERVAL=1';表示每天执行一次,如果将INTERVAL改为7就表示每7天执行一次,效果等同于FREQ=WEEKLY;INTERVAL=1。@H_301_7@
一般来说,使用DBMS_SCHEDULER.CREATE_JOB创建一个JOB,至少需要指定上述参数中的前3项。除此之外,还可以在CREATE_JOB时,指定下列参数:@H_301_7@
- NUMBER_OF_ARGUMENTS :指定该JOB执行时需要附带的参数的数量,默认值为0,注意当JOB_TYPE列值为PLsql_BLOCK或CHAIN时,本参数必须设置为0,因为上述两种情况下不支持附带参数。
- END_DATE :指定任务的过期时间,默认值为NULL。任务过期后,任务的STATE将自动被修改为COMPLETED,ENABLED被置为FALSE。如果该参数 设置为空的话,表示该任务永不过期,将一直按照REPEAT_INTERVAL参数设置的周期重复执行,直到达到设置的MAX_RUNS或 MAX_FAILURES值。
- JOB_CLASS :指定任务关联的CLASS,默认值为DEFAULT_JOB_CLASS。关于JOBCLASS的信息就关注本系列的后续文章。
- ENABLED :指定任务是否启用,默认值为FALSE。FALSE状态表示该任务并不会被执行,除非被用户手动调用,或者用户将该任务的状态修改为TRUE。
- AUTO_DROP :当该标志被置为TRUE时,ORACLE会在满足条件时自动删除创建的任务
- 任务已过期;
- 任务最大运行次数已达MAX_RUNS的设置值;
- 任务未指定REPEAT_INTERVAL参数,仅运行一次;
该参数的默认值即为TRUE。用户在执行CREATE_JOB过程时可以手动将该标志指定为FALSE,当参数值设置为FALSE时,即使满足上述提到的条件任务也不会被自动删除,这种情况下,唯一能够导致任务被删除的情况,就是用户主动调用DROP_JOB过程。@H_301_7@
- COMMENTS :设置任务的注释信息,默认值为NULL。
上面的例子创建了一个新的JOB,不过这个JOB与普通JOB不同哟,此时查询USER_JOBS视图是查不到刚刚创建的JOB的信息,因为这个JOB 是SCHEDULER管理的JOB。要查询SCHEDULER管理的JOS,应该通过USER_SCHEDULER_JOBS(当然 ALL_SCHEDULER_JOBS和DBA_SCHEDULER_JOBS也可以),例如:@H_301_7@
sql>selectjob_name,job_type,job_action,to_char(start_date,'yyyy-mm-ddhh24:mi:ss'),repeat_interval,enabled,statefromuser_scheduler_jobs;@H_301_7@
JOB_NAMEJOB_TYPEJOB_ACTIONTO_CHAR(START_DATE,REPEAT_INTERVALENABLSTATE@H_301_7@
----------------------------------------------------------------------------------------------------------------------------------@H_301_7@ INSERT_TEST_TBLSTORED_PROCEDUREP_INSERTINTOTEST2009-07-2713:46:50FREQ=DAILY;INTERVAL=1FALSEDISABLED
不过,细心的盆友可能会发现,JOB虽然成功创建了,但却并未执行,这是怎么回事?其实原因很简单,还记的前面介绍CREATE_JOB过程时提到的 ENABLED参数吗,当不显式指定时,该参数的默认值为false,JOB自然不会运行了。如果遇到这类情形,如何修改呢?请继续关注下一节。@H_301_7@
1.2 管理Jobs
1.2.1 启用Jobs
前面创建JOB时,由于未显式的指定ENABLED参数,因此即使指定了START_DATE,不过默认情况下JOB不会自动执行。对于这种情况,DBMS_SCHEDULER包中提供了一个过程ENABLE,可以用来修改JOB的启用状态,调用方式非常简单,例如:@H_301_7@
1.2.2 禁用Jobs
DBMS_SCHEDULER.ENABLE 仅用来将JOB(其实不仅仅对JOB有效,对于CHAIN、PROGRAM等也有效)的启用状态置为TRUE。如果想将其启用状态置为FALSE?简单, 还有一个与该功能对应的过程:DBMS_SCHEDULER.DISABLE,例如:@H_301_7@
这两个过程仅用来重置对象的状态,因此均可以无限次执行,即使执行时对象已经被置为要指定的状态。@H_301_7@
1.2.3 修改Jobs
由于JOB的属性众多,难免时不时的可能会遇到需要修改的情况,比如说前面创建JOB时不小心,指定要执行的过程名输入错误(完全有可能,CREATE_JOB在创建时不会自动检查指定的过程是否有效,从这方面考虑,SCHEDULER不如普通JOB严谨哪),这种情况下就必然涉及到对JOB的修改(或者说重定义),没问题,DBMS_SCHEDULER包中专门提供了一个过程SET_ATTRIBUTE,可以用来修改任务的属性值。@H_301_7@
例如,修改刚刚创建的JOB:INSERT_TEST_TBL执行的过程,执行语句如下:@H_301_7@
当然啦,我们这里执行的这条语句,执行跟没执行没有区别,此处仅做示例,大家表深究。@H_301_7@
SET_ATTRIBUTE 过程虽然仅有三个参数,不过能够修改的属性值可是不少,以下列举几个较常用到的:@H_301_7@
- LOGGING_LEVEL :指定对jobs执行情况记录的日志信息级别。
SCHEDULER 管理的JOB对任务的执行情况专门进行了记录,同时用户还可以选择日志中记录信息的级别,有下列三种选择:@H_301_7@
- DBMS_SCHEDULER.LOGGING_OFF :关闭日志记录功能;
- DBMS_SCHEDULER.LOGGING_RUNS :对任务的运行信息进行记录;
- DBMS_SCHEDULER.LOGGING_FULL :记录任务所有相关信息,不仅有任务的运行情况,甚至连任务的创建、修改等也均将记入日志。
提示:查看SCHEDULER管理的JOB,可以通过USER_SCHEDULER_JOB_LOG和USER_SCHEDULER_JOB_RUN_DETAILS两个视图中查询@H_301_7@
- RESTARTABLE :指定jobs运行出错后,是否能够适时重启
创建任务时如未明确指定,本参数默认情况下设置为FALSE,如果设置为TRUE,就表示当任务运行时出错,下次运行时间点到达时仍会启动,并且如果运行仍然出错,会继续重新运行,不过如果连接出错达到6次,该job就会停止。@H_301_7@
- MAX_FAILURES :指定jobs最大连续出错次数
该参数值可指定的范围从1-1000000,默认情况下该参数设置为NULL,表示无限制。达到指定出错次数后,该job会被自动disable。@H_301_7@
- MAX_RUNS :指定jobs最大运行次数
该 参数值可指定的范围从1-1000000,默认情况下该参数设置为NULL,表示无限制(只是运行次数无限制,实际job会否继续运行,仍受制于 end_date以及max_failures等参数的设置)。达到指定运行次数后,该job也将被自动disable,并且状态会被置为 COMPLETED。@H_301_7@
- JOB_TYPE :指定job执行的任务的类型
有四个可选值:¨PLsql_BLOCK¨,¨STORED_PROCEDURE¨,¨EXECUTABLE¨,and¨CHAIN¨。@H_301_7@
- JOB_ACTION :指定job执行的任务
这一参数所指定的值依赖于JOB_TYPE参数中的值,比如说JOB_TYPE设置为¨STORED_PROCEDURE¨,那么本参数值中指定的一定是ORACLE中的过程名。@H_301_7@
- START_DATE :指定job初次启动的时间
- END_DATE :指定job停止运行的时间
本参数又与AUTO_DROP相关联,如果AUTO_DROP设置为TRUE的话,那么一旦job到达停止运行的时间,该job就会被自动删除,否则的话job任何存在,不过状态被修改为COMPLETED。@H_301_7@
除此之外,其它还包括 MAX_RUN_DURATION,JOB_WEIGHT,INSTANCE_STICKINESS,STOP_ON_WINDOW_CLOSE,JOB_PRIORITY,SCHEDULE_LIMIT,PROGRAM_NAME,NUMBER_OF_ARGUMENTS,SCHEDULE_NAME,REPEAT_INTERVAL,JOB_CLASS,COMMENTS,AUTO_DROP,EVENT_SPEC,RAISE_EVENTS 等等,这些参数所代表的意义此处不一一详述,感兴趣的朋友可以查阅相关官方文档,或者等待本系列文章的外传,黑黑。@H_301_7@
仅从这些可设置属性就可以看出,Scheduler管理的job确实非常灵活,上述提到了这些参数,均可以使用DBMS_SCHEDULER.SET_ATTRIBUTE过程进行设置。@H_301_7@
另外需要注意一点,除了用户手动创建的jobs之外,数据库在运行过程中也有可能自动创建jobs。对于这类jobs除非必要,否则不建议进行修改。至于如何区分jobs是用户创建,还是数据库自动创建,可以通过*_SCHEDULER_JOBS视图的SYSTEM列来确定,如果该列显示为TRUE,则表示由系统创建@H_301_7@
1.2.4 执行Jobs
虽然说jobs大多都应该是自动执行,不过经过前面的示例,大家想必也认识到了,并不是说创建了jobs它就会自动执行,是否能够真正自动执行并不是由你的主观意愿就能直接决定,而是由jobs自身的多个相关属性决定。@H_301_7@
关于jobs自动执行的话题相信看完前面的内容后,应该都知道如何设置,下面主要演示,如何手动调用jobs并执行,这其中,当然少不了DBMS_SCHEDULER包。例如,手动执行前面刚刚创建的job:INSERT_TEST_TBL:@H_301_7@
Jobs 每执行一次,无论成功或失败,均会在*_SCHEDULER_JOB_LOG中生成一条对应的记录(前提是LOGGING_LEVEL属性值未设置为 DBMS_SCHEDULER.LOGGING_OFF),同时,用户也可以通过*_SCHEDULER_JOB_RUN_DETAILS视图查询job 执行的详细信息。@H_301_7@
1.2.5 停止Jobs
停止job可以使用DMBS_SCHEDULER.STOP_JOB过程,例如:@H_301_7@
注意,STOP_JOB过程不仅仅是更新job的状态,而是停止当前正在执行的任务,如果你处理的任务当前未在运行的话,那么执行STOP_JOB过程,会触发ORA-27366错误。@H_301_7@
停止Jobs也会触发一条任务的日志信息,对于执行停止操作的job,其*_SCHEDULER_JOB_LOG视图的OPERATION会记录 为¨STOPPED¨,ADDITIONAL_INFO列中记录的信息类 似¨REASON="Stopjobcalledbyuser:username"¨。@H_301_7@
1.2.6 删除Jobs
删除创建的job就比较简单了,直接执行DBMS_SCHEDULER.DROP_JOB过程即可,例如:@H_301_7@
删除jobs并不是修改该job中某个字段的标记值,而是直接删除其在数据字典中的字义,因此被删除的job如果未来发现仍然需要,只能重建,而无法通过其它方式快速恢复。不过,删除jobs的操作,并不会级联删除这些job曾经执行过的日志信息。@H_301_7@
=======================================@H_301_7@
二、使用Programs
在论坛中偶尔见过有人讨论如何在ORACLE中执行操作系统命令,或是ORACLE数据库外的应用。应该说在9i及之前的版本中,虽然说并非完全无法实现(其实还是有多种方式能够变相实现的),不过复杂的实现方式让DBA使劲了力,伤透了心,费劲了事儿。@H_301_7@
进入10g版本之后,就完全不必如此费神,因为有了DBMS_SCHEDULER,因为有了PROGRAM。@H_301_7@
2.1 创建Programs
Scheduler 中的Program对象并不是常规意义上的"程序"或"应用",而就是一个"对象",由DBA定义的,具有执行某项功能的特殊对象。Program中实际执行的操作可以分为下列三种类型:@H_301_7@
- PL/sqlBLOCK :标准的pl/sql代码块;
- STOREDPROCEDURE :编译好的PL/sql存储过程,或者Java存储过程,以及外部的c子程序;
- EXECUTEABLE :ORACLE数据库之外的应用,比如操作系统命令等等。
创建Programs使用DBMS_SCHEDULER.CREATE_PROGRAM过程,该过程支持的参数如下:@H_301_7@
JSSWEB> descdbms_scheduler.create_program;@H_301_7@
ParameterTypeModeDefault?@H_301_7@
---------------------------------------------@H_301_7@
PROGRAM_NAMEVARCHAR2IN@H_301_7@
PROGRAM_TYPEVARCHAR2IN@H_301_7@
PROGRAM_ACTIONVARCHAR2IN@H_301_7@
NUMBER_OF_ARGUMENTSBINARY_INTEGERINY@H_301_7@
ENABLEDBOOLEANINY@H_301_7@ OMMENTSVARCHAR2INY
如上所示,前三项为必选参数,各参数实际代表的意义如下:@H_301_7@
- PROGRAM_NAME :指定一个program名称;
- PROGRAM_TYPE :Program的类型,如前文中所述,Program支持三种类型;
- PROGRAM_ACTION :实际执行的操作,应与前面PROGRAM_TYPE参数关联使用。比如说前面指定了PROGRAM_TYPE为"PLsql_BLOCK",那么此处要 执行的action就应当是一段标准的pl/sql代码。如果前面指定PROGRAM_TYPE为"STORED_PROCEDURE",那么此处要执行 的action就应当是ORACLE中定义好的存储过程(含Java存储过程),如果前面指定PROGRAM_TYPE为"EXECUTABLE",那么 此处就应该指定外部命令的命令行信息(含路径信息);
- NUMBER_OF_ARGUMENTS :指定支持的参数个数,默认值为0即没有参数。每个program最多能够支持255个参数,注意如果PROGRAM_TYPE设置为PLsql_BLOCK,那么本参数自动忽略;
- ENABLED :指定是否将创建的program置为有效状态,默认情况下为false。
- COMMENTS :这个不用再说了吧,注释信息。
下面实际操作一下看看,PL/sql或PROCEDURE没有挑战(ORACLE中直接即可调用),咱们创建一下program,直接调用操作系统中的ls命令,操作如下:@H_301_7@
2.2 管理Programs
定义的program如何执行,这里先卖个关子,前面介绍CREATE_PROGRAM过程的参数时提到,每个program最多支持255个参数,要 为program添加参数,可以通过DEFINE_PROGRAM_ARGUMENT过程。不过在为其添加参数前,要注意program的 NUMBER_OF_ARGUMENTS指定的数量,如果该值为0,那么为其添加参数时就会报错。@H_301_7@
查询创建的program的信息,可以通过USER_SCHEDULER_PROGRAMS视图,例如:@H_301_7@
sql>selectprogram_name,program_type,program_action,number_of_arguments,enabled@H_301_7@
2fromuser_scheduler_programs;@H_301_7@
PROGRAM_NAMEPROGRAM_TYPEPROGRAM_ACTIONNUMBER_OF_ARGUMENTSENABL@H_301_7@
--------------------------------------------------------------------------------@H_301_7@ MY_PROGRAM1EXECUTABLE/bin/ls1FALSE
由于前面创建program時並未指定NUMBER_OF_ARGUMENTS的值,因此我们这里需要首先修改该值为一个非0值,操作如下:@H_301_7@
没错,操作还是使用DBMS_SCHEDULER.SET_ATTRIBUTE过程。另外需要注意,program的 NUMBER_OF_ARGUMENTS参数可是说想改就能改的,正常情况下该处理必须是在program处于enabled之前确认完毕,否则会触发 ORA-27465错误,因此要修改program的参数之前,必须首先确保要修改program的enabled状态为false。@H_301_7@
那么对于已经处于enabled状态的program,如何修改其状态属性呢?其实很简单,前面操作jobs时使用的DBMS_SCHEDULER.DISABLE过程还记的吗?没错,该过程对于program同样好使,并且调用方式也完全一样,例如:@H_301_7@
另外,如果希望将program置为enabled状态,执行DBMS_SCHEDULER.ENABLE过程即可,这里不再例举。@H_301_7@
接下来,就可以为刚刚创建的my_program1添加路径参数,操作如下:@H_301_7@
查询为program定义的参数,可以通过USER_SCHEDULER_PROGRAM_ARGS视图,例如:@H_301_7@
sql>selectprogram_name,argument_name,argument_position,argument_type@H_301_7@
2default_valuefromuser_scheduler_program_args;@H_301_7@
PROGRAM_NAMEARGUMENT_NAMEARGUMENT_POSITIONDEFAULT_VALUE@H_301_7@
-----------------------------------------------------------------------------@H_301_7@ MY_PROGRAM1DIRPATH1VARCHAR2
删除program的argument操作也很简单,使用DROP_PROGRAM_ARGUMENT过程即可,例如:@H_301_7@
该过程第一个参数指定program名称,第二个参数指定定义的argument名称,当然此处也可以指定argument的位置,即前例视图返回结果中的 ARGUMENT_POSITION 列值。@H_301_7@
要删除program的话就更简单了,使用DROP_PROGRAM过程即可,例如:@H_301_7@
当然啦,删除program的同时,也会删除该program对应的所有arguments。@H_301_7@
实际上SCHEDULER中创建job时,也可以指定执行外部的程序。SCHEDULER中的Job更像是之前版本继承过来的JOBS,只不过10g中 SCHEDULER管理的JOBS功能更加强大。Programs与Jobs不同的是,Jobs是定义好的,定时执行的任务,而Programs则是定义 好的,等待被执行的对象。那么Programs是由谁来执行呢,不要走开,广告之后即将全面揭晓。@H_301_7@
=======================================@H_301_7@
三、使用Schedules
10g 中新推出的SCHEDULER可 能确实会让很多初接触的朋友感觉晕头晕脑,相比之前的jobs,SCHEDULER中新增的概念太多。比如说jobs,仍然可以理解成之前版本中的 jobs,不过功能更加强大(注意10g中也仍然可以使用普通jobs,这是废话,相信看本篇文章的朋友目前应该还是这样在用),比如说program, 指的是运行的程序(把要做什么单提出来了),比如说schedule,我将其翻译为调度(job我翻译为任务),定义执行的频率或者说周期。@H_301_7@
3.1 创建和管理Schedule s
Schedule ,中文直译的话应该理解成调度,从名字来看,它是一个逻辑实体(逻辑,还实体,好矛盾),就是说当创建了schedule之后,数据库中就肯定存在这一对象,只不过这一对象是用来描述job的执行周期。@H_301_7@
创建schedule可以通过DBMS_SCHEDULER.CREATE_SCHEDULE过程,该过程支持的参数如下:@H_301_7@
sql>descdbms_scheduler.create_schedule;@H_301_7@
ParameterTypeModeDefault?@H_301_7@
---------------------------------------------------@H_301_7@
SCHEDULE_NAMEVARCHAR2IN@H_301_7@
START_DATETIMESTAMPWITHTIMEZONEINY@H_301_7@
REPEAT_INTERVALVARCHAR2IN@H_301_7@
END_DATETIMESTAMPWITHTIMEZONEINY@H_301_7@ COMMENTSVARCHAR2INY
各参数分别代表含意如下:@H_301_7@
- SCHEDULE_NAME :指定schedule名称,注意名称不能重复。
- START_DATE :指定该调度的开始时间,可为空,当为空时表示该调度暂不起用。
- REPEAT_INTERVAL :指定调度的执行频率或周期。
- END_DATE :指定调度的结束时间,可为空,为空时就表示该调度将一直进行。
- COMMENTS :注释信息。
这其中,比较有技术含 量的是REPEAT_INTERVAL参数,对于这个参数大家应该不会太陌生,因为前面介绍Jobs,也曾经提到过同名的参数,Schedules中的 REPEAT_INTERVAL参数和Jobs中的REPEAT_INTERVAL参数功能完全相同,甚至参数格式也一模一样。@H_301_7@
REPEAT_INTERVAL 参数的语法结构要复杂的多。其中最重要的是FREQ和INTERVAL两个关键字。@H_301_7@
- FREQ 关键字用来指定间隔的时间周期,可选参数有:YEARLY,andSECONDLY,分别表示年、月、周、日、时、分、秒等单位。
- INTERVAL 关键字用来指定间隔的频繁,可指定的值的范围从1-99。
比如说,当指定REPEAT_INTERVAL=>'FREQ=DAILY;INTERVAL=1';就表示每天执行一次,如果将INTERVAL改为7就表示每7天执行一次,效果等同于FREQ=WEEKLY;INTERVAL=1。@H_301_7@
下面,创建一个schedule,指定调度为每周一次的频率,执行脚本如下:@H_301_7@
查询当前已经创建的schedules,可以通过*_SCHEDULER_SCHEDULES视图(含DBA_,ALL_,USER_),例如,查看当前用户拥有的schedules,执行语句如下:@H_301_7@
如果要修改schedule属性的话,也是使用DBMS_SCHEDULER.SET_ATTRIBUTE过程,该过程的调用方式前面已经多次演示过, 这里就不再重复举例了,仅说明一点,对于schedule来说,能够修改的属性包括:REPEAT_INTERVAL、COMMENTS、 END_DATE、START_DATE以及EVENT_SPEC。@H_301_7@
至于删除schedule,再简单不过,执行DBMS_SCHEDULER.DROP_SCHEDULE过程即可,例如:@H_301_7@
sql>EXECDBMS_SCHEDULER.DROP_SCHEDULE('MY_FIRST_SCHEDULE');@H_301_7@ PL/sqlproceduresuccessfullycompleted