1.Schedule(计划)的基本概念
Oracle 中的job主要用来管理和计划数据库的Job,通过它可以让很多常规的数据库任务自动执行,减少人为干预,解放劳动力,本质上来说,它和Linux的crontab,商业任务管理软件如Autosys, UC4一样,只是它们的领域不一样,Oracle JOB专注于Oracle数据库Job的自动化管理、维护和监控。
所谓出于job而胜于job,说的就是Oracle 10g后的新特性Scheduler。在10g环境中,ORACLE建议使用Scheduler替换普通的job,来管理任务的执行。其实,将Scheduler描述成管理job的工具已经太过片面了,10G版本中新增的Scheduler绝不仅仅是创建任务这么简单。(DBMS_SCHEDULER包)
2.使用Jobs
所谓JOBS,其实就是Scheduler管理的一个(或多个)任务的执行调度。
2.1 创建Jobs
通过DBMS_SCHEDULER包来创建Jobs,是使用其CREATE_JOB过程。在创建Job时,用户可以指定要执行的任务,调度信息(什么时候执行,执行周期,终止日期等,以及其它一些任务相关的属性)。例如:
create table test(id int);
create or replace procedure p_insert as
begin
insert into test values(1);
commit;
end;
/
begin
dbms_scheduler.create_job (
job_name => 'INSERT_TEST',
job_type => 'STORED_PROCEDURE',
job_action => 'SYS.P_INSERT',
start_date => sysdate,
repeat_interval => 'FREQ=MINUTELY;INTERVAL=2'
);
end;
/
----每两分钟执行一次sys下的p_insert存储过程。默认是为启用该job的,需要手动enable,见后面。
事实上,有权限的话,用户也可以创建其它SCHEMA下的JOB,只需要在指定JOB_NAME 时,按照schema.job_name的格式即可。这种情况下创建的JOB,其CREATED 与OWNER 有可能并不相同。当使用CREATE_JOB 过程创建JOB 时,可指定的参数值很多,只不过多数情况下用户仅指定部分参数即可满足需求。
2.2 创建Jobs使用到的参数释义
JOB_NAME:指定任务的名称,必选值,注意要确保指定的名称唯一。
JOB_TYPE:任务执行的操作类型,必选值,有下列几个可选值:
PLSQL_BLOCK:表示任务执行的是一个PL/SQL 匿名块。
STORED_PROCEDURE:表示任务执行的是ORACLE 过程(含PL/SQL PROCEDURE 和Java PROCEDURE),本例中正是指定这一参数值。
EXECUTABLE:表示任务执行的是一个外部程序,比如说操作系统命令。
CHAIN:表示任务执行的是一个CHAIN。
JOB_ACTION:任务执行的操作,必选值,应与JOB_TYPE 类型中指定的参数相匹配。比如说对于PL/SQL 匿名块,此处就可以放置PL/SQL 块的具体代表,类似DECLARE .. BEGIN ..END这类;如果是ORACLE 过程,那么此处应该指定具体的过程名,注意由于任务执行,即使过程中有OUT之类参数,实际执行时也不会有输出的。
START_DATE:指定任务初次执行的时间,本参数可为空,当为空时,表示任务立刻执行,效果等同于指定该参数值为SYSDATE。
REPEAT_INTERVAL:指定任务执行的频率,比如多长时间会被触发再次执行。本参数也可以为空,如果为空的话,就表示当前设定的任务只执行一次。REPEAT_INTERVAL 参数与标准JOB 中的INTERVAL 参数有很大区别,相比之下,REPEAT_INTERVAL 参数的语法结构要复杂的多。其中最重要的是FREQ 和INTERVAL 两个关键字。
FREQ 关键字用来指定间隔的时间周期,可选参数有:YEARLY, MONTHLY, WEEKLY, DAILY,HOURLY, MINUTELY, and SECONDLY,分别表示年、月、周、日、时、分、秒等单位。
INTERVAL 关键字用来指定间隔的频繁,可指定的值的范围从1-99。例如:REPEAT_INTERVAL=>'FREQ=DAILY;INTERVAL=1';表示每天执行一次,如果将INTERVAL 改为7 就表示每7 天执行一次,效果等同于FREQ=WEEKLY;INTERVAL=1。
一般来说,使用DBMS_SCHEDULER.CREATE_JOB 创建一个JOB,至少需要指定上述参数中的前3 项。除此之外,还可以在CREATE_JOB 时,指定下列参数:
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。
ENABLED:指定任务是否启用,默认值为FALSE。FALSE 状态表示该任务并不会被执行,除非被用户手动调用,或者用户将该任务的状态修改为TRUE。
AUTO_DROP:当该标志被置为TRUE 时,ORACLE 会在满足条件时自动删除创建的任务
1)任务已过期;
2)任务最大运行次数已达MAX_RUNS 的设置值;
3)任务未指定REPEAT_INTERVAL 参数,仅运行一次;
该参数的默认值即为TRUE。用户在执行CREATE_JOB 过程时可以手动将该标志指定为FALSE,当参数值设置为FALSE 时,即使满足上述提到的条件任务也不会被自动删除,这种情况下,唯一能够导致任务被删除的情况,就是用户主动调用DROP_JOB 过程。
COMMENTS:设置任务的注释信息,默认值为NULL。
2.3 查看Jobs
上面的例子创建了一个新的JOB,不过这个JOB 与普通JOB 不同,此时查询USER_JOBS 视图是查不到刚刚创建的JOB 的信息,因为这个JOB 是SCHEDULER 管理的JOB。要查询SCHEDULER 管理的JOBS,应该通过user_scheduler_jobs(all_scheduler_jobs,dba_scheduler_jobs) 例如:
select job_name,job_type,job_action,to_char(start_date,'yyyy-mm-dd hh24:mi:ss') TM,repeat_interval,enabled,state from user_scheduler_jobs;
JOB_NAME JOB_TYPE JOB_ACTION TM REPEAT_INTERVAL ENABL STATE
---------- ---------------- ---------- ---------- ------------------------- ------ ------
INSERT_TEST STORED_PROCEDURE SYS.P_INSERT 2016-04-26 00:07:47 FREQ=MINUTELY;INTERVAL=11 FALSE DISABLED
注意:JOB 虽然成功创建了,但却并未执行。因为ENABLED 参数当不显式指定时,该参数的默认值为false。
2.4 管理Jobs
2.4.1 启用Jobs
前面创建JOB 时,由于未显式的指定ENABLED 参数,因此即使指定了START_DATE,不过默认情况下JOB不会自动执行。对于这种情况,DBMS_SCHEDULER 包中提供了一个过程ENABLE,可以用来修改JOB 的启用状态,调用方式非常简单,例如:
sys@ORCL>exec dbms_scheduler.enable('INSERT_TEST');
PL/SQL procedure successfully completed.
2.4.2 禁用Jobs
DBMS_SCHEDULER.ENABLE 仅用来将JOB(其实不仅仅对JOB 有效,对于CHAIN、PROGRAM 等也有效)的启用状态置为TRUE。如果想将其启用状态置为FALSE,还有一个与该功能对应的过程:DBMS_SCHEDULER.DISABLE,如:
sys@ORCL>exec dbms_scheduler.disable('INSERT_TEST');
PL/SQL procedure successfully completed.
sys@ORCL>exec dbms_scheduler.ENABLE('INSERT_TEST');
----------这两个过程仅用来重置对象的状态,因此均可以无限次执行,即使执行时对象已经被置为要指定的状态。
2.4.3 修改Jobs
由于JOB 的属性众多,难免可能会遇到需要修改的情况,比如说前面创建JOB 时不小心指定要执行的过程名输入错误(CREATE_JOB 在创建时不会自动检查指定的过程是否有效),这种情况下就必然涉及到对JOB 的修改(或者说重定义),DBMS_SCHEDULER 包中专门提供了一个过程SET_ATTRIBUTE,可以用来修改任务的属性值。
例如,修改刚刚创建的JOB:INSERT_TEST 执行的过程,执行语句如下:
sys@ORCL>exec dbms_scheduler.set_attribute('INSERT_TEST','JOB_ACTION','SYS.P_UPDATE');
PL/SQL procedure successfully completed.
SET_ATTRIBUTE 过程虽然仅有三个参数,不过能够修改的属性值可是不少,以下列举几个较常用到的:
1> LOGGING_LEVEL:指定对jobs 执行情况记录的日志信息级别。SCHEDULER 管理的JOB 对任务的执行情况专门进行了记录,同时用户还可以选择日志中记录信息的级别,有下列三种选择:
1)DBMS_SCHEDULER.LOGGING_OFF:关闭日志记录功能;
2) DBMS_SCHEDULER.LOGGING_RUNS:对任务的运行信息进行记录;
3) DBMS_SCHEDULER.LOGGING_FULL:记录任务所有相关信息,不仅有任务的运行情况,甚至连任务的创建、修改等也均将记入日志。
提示:查看schedule管理的job,可以通过user_scheduler_job_log和user_scheduler_job_run_details两个视图中查询。
2> RESTARTABLE:指定jobs 运行出错后,是否能够适时重启创建任务时如未明确指定,本参数默认情况下设置为FALSE,如果设置为TRUE,就表示当任务运行时出错,下次运行时间点到达时仍会启动,并且如果运行仍然出错,会继续重新运行,不过如果连接出错达到6 次,该job 就会停止。
3> MAX_FAILURES:指定jobs 最大连续出错次数该参数值可指定的范围从1-1 000 000,默认情况下该参数设置为NULL,表示无限制。达到指定出错次数后,该job 会被自动disable。
4> MAX_RUNS:指定jobs 最大运行次数,该参数值可指定的范围从1-1 000 000,默认情况下该参数设置为NULL,表示无限制(只是运行次数无限制,实际job 是否继续运行,仍受制于end_date 以及max_failures 等参数的设置)。达到指定运行次数后,该job 也将被自动disable,并且状态会被置为COMPLETED。
5> JOB_TYPE:指定job 执行的任务的类型,有四个可选值: 'PLSQL_BLOCK', 'STORED_PROCEDURE', 'EXECUTABLE', and 'CHAIN'。
6> JOB_ACTION:指定job 执行的任务。这一参数所指定的值依赖于JOB_TYPE 参数中的值, 比如说JOB_TYPE 设置为'STORED_PROCEDURE',那么本参数值中指定的一定是ORACLE 中的过程名。
7> START_DATE:指定job 初次启动的时间
8> END_DATE:指定job 停止运行的时间
本参数又与AUTO_DROP 相关联,如果AUTO_DROP 设置为TRUE 的话,那么一旦job 到达停止运行的时间,该job 就会被自动删除,否则的话job 任何存在,不过状态被修改为COMPLETED。
除此之外, 其它还包括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 等等。
另外需要注意一点,除了用户手动创建的jobs 之外,数据库在运行过程中也有可能自动创建jobs。对于这类jobs 除非必要,否则不建议进行修改。至于如何区分jobs 是用户创建,还是数据库自动创建,可以通过*_SCHEDULER_JOBS 视图的SYSTEM 列来确定,如果该列显示为TRUE,则表示由系统SYS创建。
2.4.4 执行Jobs
虽然说jobs大多都应该是自动执行,不过经过前面的示例,大家想必也认识到了,并不是说创建了jobs它就会自动执行,是否能够真正自动执行并不是由你的主观意愿就能直接决定,而是由jobs自身的多个相关属性决定。
关于jobs自动执行的话题相信看完前面的内容后,应该都知道如何设置,下面主要演示,如何手动调用jobs并执行,这其中,当然少不了DBMS_SCHEDULER包。例如,手动执行前面刚刚创建的job:INSERT_TEST:
sys@ORCL>exec dbms_scheduler.run_job('INSERT_TEST');
PL/SQL procedure successfully completed.
Jobs 每执行一次,无论成功或失败,均会在*_SCHEDULER_JOB_LOG中生成一条对应的记录(前提是LOGGING_LEVEL属性值未设置为 DBMS_SCHEDULER.LOGGING_OFF),同时,用户也可以通过*_SCHEDULER_JOB_RUN_DETAILS视图查询job 执行的详细信息。
SELECT * FROM USER_SCHEDULER_JOB_LOG WHERE JOB_NAME='INSERT_TEST' ORDER BY LOG_ID;
2.4.5 停止Jobs
停止job可以使用DMBS_SCHEDULER.STOP_JOB过程,例如:
sys@ORCL>eXec dbms_scheduler.stop_job('INSERT_TEST');
PL/SQL procedure successfully completed.
注意,STOP_JOB过程不仅仅是更新job的状态,而是停止当前正在执行的任务,如果你处理的任务当前未在运行的话,那么执行STOP_JOB过程,会触发ORA-27366错误。
停止Jobs也会触发一条任务的日志信息,对于执行停止操作的job,其*_SCHEDULER_JOB_LOG视图的OPERATION会记录为¨STOPPED¨,ADDITIONAL_INFO列中记录的信息类似¨REASON="Stop job called by user: username"¨。
2.4.6 删除Jobs
删除创建的job就比较简单了,直接执行DBMS_SCHEDULER.DROP_JOB过程即可,例如:
sys@ORCL>exec dbms_scheduler.drop_job('INSERT_TEST');
PL/SQL procedure successfully completed.
删除jobs并不是修改该job中某个字段的标记值,而是直接删除其在数据字典中的字义,因此被删除的job如果未来发现仍然需要,只能重建,而无法通过其它方式快速恢复。不过,删除jobs的操作,并不会级联删除这些job曾经执行过的日志信息。
3.使用Programs
在论坛中偶尔见过有人讨论如何在ORACLE中执行操作系统命令,或是ORACLE数据库外的应用。应该说在9i及之前的版本中,虽然说并非完全无法实现(其实还是有多种方式能够变相实现的),不过复杂的实现方式让DBA使劲了力,伤透了心,费劲了事儿。
进入10g版本之后,就完全不必如此费神,因为有了DBMS_SCHEDULER,因为有了PROGRAM。
3.1 创建Programs
Scheduler 中的Program 对象并不是常规意义上的"程序"或"应用",而就是一个"对象",由DBA 定义的,具有执行某项功能的特殊对象。Program 中实际执行的操作可以分为下列三种类型:
1> PL/SQL BLOCK:标准的pl/sql 代码块;
2> STORED PROCEDURE:编译好的PL/SQL 存储过程,或者Java 存储过程,以及外部的子程序;
3> EXECUTEABLE:ORACLE 数据库之外的应用,比如操作系统命令等等。
创建Programs 使用DBMS_SCHEDULER.CREATE_PROGRAM 过程,该过程支持的参数如下:
1> PROGRAM_NAME :指定一个program名称;
2> PROGRAM_TYPE :Program的类型,如前文中所述,Program支持三种类型;
3> PROGRAM_ACTION :实际执行的操作,应与前面PROGRAM_TYPE参数关联使用。比如说前面指定了PROGRAM_TYPE为"PLSQL_BLOCK",那么此处要执行的action就应当是一段标准的pl/sql代码。如果前面指定PROGRAM_TYPE为"STORED_PROCEDURE",那么此处要执行的action就应当是ORACLE中定义好的存储过程(含Java存储过程),如果前面指定PROGRAM_TYPE为"EXECUTABLE",那么此处就应该指定外部命令的命令行信息(含路径信息);
4> NUMBER_OF_ARGUMENTS :指定支持的参数个数,默认值为0即没有参数。每个program最多能够支持255个参数,注意如果PROGRAM_TYPE设置为PLSQL_BLOCK,那么本参数自动忽略;
5> ENABLED :指定是否将创建的program置为有效状态,默认情况下为false。
6> COMMENTS :这个不用再说了吧,注释信息。
下面实际操作一下看看,创建一下program,直接调用操作系统中的date命令,操作如下:
BEGIN
DBMS_SCHEDULER.CREATE_PROGRAM (
program_name => 'my_program_date',
program_action => '/bin/date',
program_type => 'EXECUTABLE',
enabled => TRUE
);
END;
/
3.2 管理Programs
前面介绍CREATE_PROGRAM过程的参数时提到,每个program最多支持255个参数,要为program添加参数,可以通过DEFINE_PROGRAM_ARGUMENT过程。不过在为其添加参数前,要注意program的 NUMBER_OF_ARGUMENTS指定的数量,如果该值为0,那么为其添加参数时就会报错。
查询创建的program的信息,可以通过USER_SCHEDULER_PROGRAMS视图,例如:
select program_name,program_type,program_action,number_of_arguments,enabled from user_scheduler_programs;
PROGRAM_NAME PROGRAM_TYPE PROGRAM_ACTION NUMBER_OF_ARGUMENTS ENABL
-------------------- ---------------- -------------------- ------------------- -----
MY_PROGRAM_DATE EXECUTABLE /bin/date 0 TRUE
由于前面创建program时并未指定NUMBER_OF_ARGUMENTS的值,因此我们这里需要首先修改该值为一个非0值,操作如下:
exec dbms_scheduler.set_attribute('MY_PROGRAM_DATE','NUMBER_OF_ARGUMENTS',1);
*
ERROR at line 1:
ORA-27470: failed to re-enable "SYS.MY_PROGRAM_DATE" after making requested change
ORA-27456: not all arguments of program "SYS.MY_PROGRAM_DATE" have been defined
ORA-06512: at "SYS.DBMS_ISCHED", line 4467
ORA-06512: at "SYS.DBMS_SCHEDULER", line 2851
ORA-06512: at line 1
没错,操作还是使用DBMS_SCHEDULER.SET_ATTRIBUTE过程。另外需要注意,program的NUMBER_OF_ARGUMENTS参数不是想改就能改的,正常情况下该处理必须是在program处于enabled之前确认完毕,否则会触发 ORA-27470、ORA-27465错误,因此要修改program的参数之前,必须首先确保要修改program的enabled状态为false。
那么对于已经处于enabled状态的program,如何修改其状态属性呢?其实很简单,前面操作jobs时使用的DBMS_SCHEDULER.DISABLE过程还记的吗?没错,该过程对于program同样好使,并且调用方式也完全一样,例如:
sys@ORCL>exec dbms_scheduler.disable('MY_PROGRAM_DATE');
PL/SQL procedure successfully completed.
----再次修改
select program_name,program_type,program_action,number_of_arguments,enabled from user_scheduler_programs;
PROGRAM_NAME PROGRAM_TYPE PROGRAM_ACTION NUMBER_OF_ARGUMENTS ENABL
-------------------- ---------------- -------------------- ------------------- -----
MY_PROGRAM_DATE EXECUTABLE /bin/date 1 FALSE
exec dbms_scheduler.set_attribute('MY_PROGRAM_DATE','NUMBER_OF_ARGUMENTS',1);
PL/SQL procedure successfully completed.
另外,如果希望将program置为enabled状态,执行DBMS_SCHEDULER.ENABLE过程即可,这里不再例举。
3.3 为Programs添加路径参数
BEGIN
DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT (
program_name => 'my_program_date',
argument_position => 1,
argument_name => 'path',
argument_type => 'VARCHAR2',
default_value => '/home/oracle'
);
END;
/
查询为program定义的参数,可以通过USER_SCHEDULER_PROGRAM_ARGS视图,例如:
select program_name,argument_name,argument_position,argument_type default_value from user_scheduler_program_args where program_name='MY_PROGRAM_DATE';
PROGRAM_NAME ARGUMENT_NAME ARGUMENT_POSITION DEFAULT_VALUE
-------------------- -------------------- ----------------- --------------------
MY_PROGRAM_DATE PATH 1 VARCHAR2
3.4 删除Programs
删除program的argument操作也很简单,使用DROP_PROGRAM_ARGUMENT过程即可,例如:
sys@ORCL>exec dbms_scheduler.drop_program_argument('my_program_date','path');
PL/SQL procedure successfully completed.
该过程第一个参数指定program名称,第二个参数指定定义的argument名称,当然此处也可以指定argument的位置,即前例视图返回结果中的ARGUMENT_POSITION列值。
要删除program的话就更简单了,使用DROP_PROGRAM过程即可,例如:
sys@ORCL>exec dbms_scheduler.drop_program('my_program_date');
PL/SQL procedure successfully completed.
当然啦,删除program的同时,也会删除该program对应的所有arguments。
实际上SCHEDULER中创建job时,也可以指定执行外部的程序。SCHEDULER中的Job更像是之前版本继承过来的JOBS,只不过10g中 SCHEDULER管理的JOBS功能更加强大。Programs与Jobs不同的是,Jobs是定义好的,定时执行的任务,而Programs则是定义好的,等待被执行的对象。
4.使用schedules
10g 中新推出的SCHEDULER可能确实会让很多初接触的朋友感觉晕头晕脑,相比之前的jobs,SCHEDULER中新增的概念太多。比如说jobs,仍然可以理解成之前版本中的jobs,不过功能更加强大(注意10g中也仍然可以使用普通jobs,这是废话,相信看本篇文章的朋友目前应该还是这样在用),比如说program,指的是运行的程序(把要做什么单提出来了),比如说schedule,我将其翻译为调度(job我翻译为任务),定义执行的频率或者说周期。
4.1 创建和管理Schedules
Schedule ,中文直译的话应该理解成调度,从名字来看,它是一个逻辑实体(逻辑,还实体,好矛盾),就是说当创建了schedule之后,数据库中就肯定存在这一对象,只不过这一对象是用来描述job的执行周期。
创建schedule可以通过DBMS_SCHEDULER.CREATE_SCHEDULE过程,该过程支持的参数如下:
1> SCHEDULE_NAME :指定schedule名称,注意名称不能重复。
2> START_DATE :指定该调度的开始时间,可为空,当为空时表示该调度暂不起用。
3> REPEAT_INTERVAL :指定调度的执行频率或周期。
4> END_DATE :指定调度的结束时间,可为空,为空时就表示该调度将一直进行。
5> COMMENTS :注释信息。
这其中,比较有技术含量的是REPEAT_INTERVAL参数,对于这个参数大家应该不会太陌生,因为前面介绍Jobs,也曾经提到过同名的参数,Schedules中的 REPEAT_INTERVAL参数和Jobs中的REPEAT_INTERVAL参数功能完全相同,甚至参数格式也一模一样。
REPEAT_INTERVAL中最重要的是FREQ和INTERVAL两个关键字。
FREQ 关键字用来指定间隔的时间周期,可选参数有:YEARLY, MONTHLY, WEEKLY, DAILY,HOURLY, MINUTELY, and SECONDLY,分别表示年、月、周、日、时、分、秒等单位。
INTERVAL 关键字用来指定间隔的频繁,可指定的值的范围从1-99。例如:REPEAT_INTERVAL=>'FREQ=DAILY;INTERVAL=1';表示每天执行一次,如果将INTERVAL 改为7 就表示每7 天执行一次,效果等同于FREQ=WEEKLY;INTERVAL=1。
下面,创建一个schedule,指定调度为每周一次的频率,执行脚本如下:
begin
DBMS_SCHEDULER.CREATE_SCHEDULE (
schedule_name => 'my_first_schedule',
start_date => SYSDATE,
repeat_interval => 'FREQ=WEEKLY; INTERVAL=1',
comments => 'Every 1 weeks'
);
END;
/
4.2 查询已经创建的schedules
查询当前已经创建的schedules,可以通过*_SCHEDULER_SCHEDULES视图(含DBA_,ALL_,USER_),例如,查看当前用户拥有的schedules,执行语句如下:
select schedule_name,repeat_interval from user_scheduler_schedules;
MY_FIRST_SCHEDULE FREQ=WEEKLY; INTERVAL=1
如果要修改schedule属性的话,也是使用DBMS_SCHEDULER.SET_ATTRIBUTE过程,该过程的调用方式前面已经多次演示过,这里就不再重复举例了,仅说明一点,对于schedule来说,能够修改的属性包括:REPEAT_INTERVAL、COMMENTS、 END_DATE、START_DATE以及EVENT_SPEC。
4.3 删除schedules
至于删除schedule,再简单不过,执行DBMS_SCHEDULER.DROP_SCHEDULE过程即可,例如:
sys@ORCL>exec dbms_scheduler.drop_schedule('MY_FIRST_SCHEDULE');
PL/SQL procedure successfully completed.
5.Schedules调度Programs执行的Jobs
5.1 创建Programs调用du命令
----创建Programs,用于查看路径使用空间大小
------program中调用系统命令如du时,使用了参数,后面执行job时报错,把参数去掉就可以执行成功,不知道有什么好的解决办法没
BEGIN
DBMS_SCHEDULER.CREATE_PROGRAM (
program_name => 'my_program_du',
program_action => '/usr/bin/du -sh ',
program_type => 'EXECUTABLE',
enabled => TRUE
);
END;
/
exec dbms_scheduler.disable('MY_PROGRAM_DU');
exec dbms_scheduler.set_attribute('MY_PROGRAM_DU','NUMBER_OF_ARGUMENTS',1);
----创建需要查看的路径
BEGIN
DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT (
program_name => 'my_program_du',
argument_position => 1,
argument_name => 'dirpath',
argument_type => 'VARCHAR2',
default_value => '/home/oracle'
);
END;
/
exec dbms_scheduler.enable('MY_PROGRAM_DU');
查询为program定义的参数,可以通过USER_SCHEDULER_PROGRAM_ARGS视图,例如:
select program_name,argument_name,argument_position,argument_type default_value from user_scheduler_program_args where program_name='MY_PROGRAM_DU';
PROGRAM_NAME ARGUMENT_NAME ARGUMENT_POSITION DEFAULT_VALUE
-------------------- -------------------- ----------------- --------------------
MY_PROGRAM_DU DIRPATH 1 VARCHAR2
---- exec dbms_scheduler.drop_program('my_program_du');
5.2 定义一个schedule
begin
DBMS_SCHEDULER.CREATE_SCHEDULE (
schedule_name => 'my_schedule',
start_date => SYSDATE,
repeat_interval => 'FREQ= DAILY ; INTERVAL=1',
comments => 'Every 1 days'
);
END;
/
---- exec dbms_scheduler.drop_schedule('MY_SCHEDULE');
5.3 创建JOB,按照指定的schedule执行program
BEGIN
DBMS_SCHEDULER.CREATE_JOB (
job_name => 'Path_Size',
program_name => 'my_program_du',
schedule_name => 'my_schedule',
enabled => true
);
END;
/
---- exec dbms_scheduler.drop_job('PATH_SIZE');
创建job时,start_date,repeat_interval,job_action等均无须指定,因为这些参数将由program和schedule来控制。
这样,操作完成后,ORACLE就会自动定时(当前设置为每天执行一次)program中定义的操作。
要查看当前的执行情况,通过*_scheduler_job_run_details即可查询(*_scheduler_job_log也可以,不过该视图中信息不如detail中全面)。
SELECT log_id,to_char(log_date,'yyyy-mm-dd hh24:mi:ss'), status, additional_info FROM USER_SCHEDULER_JOB_LOG WHERE JOB_NAME='PATH_SIZE' ORDER BY LOG_ID;
这里先手动触发一次执行:exec dbms_scheduler.run_job('Path_Size');
5.4 删除Programs调用的du命令参数
----手工调用job时报错
sys@ORCL>exec dbms_scheduler.run_job('Path_Size');
BEGIN dbms_scheduler.run_job('Path_Size'); END;
*
ERROR at line 1:
ORA-27369: job of type EXECUTABLE failed with exit code: No such file or directory
ORA-06512: at "SYS.DBMS_ISCHED", line 196
ORA-06512: at "SYS.DBMS_SCHEDULER", line 486
ORA-06512: at line 1
----这里修改programs参数
exec dbms_scheduler.set_attribute('MY_PROGRAM_DU','program_action','/usr/bin/du');
----再次手动调用成功
sys@ORCL>exec dbms_scheduler.run_job('Path_Size');
PL/SQL procedure successfully completed.
sys@ORCL>SELECT log_id,to_char(log_date,'yyyy-mm-dd hh24:mi:ss'), status, additional_info FROM USER_SCHEDULER_JOB_LOG WHERE JOB_NAME='PATH_SIZE' ORDER BY LOG_ID;
LOG_ID LOG_DATE STATUS ADDITIONAL_INFO
---------- --------------------------- ------------------------------------------------ --------
1710 2016-04-26 06:45:11 FAILED REASON="manually run"
1711 2016-04-26 06:45:30 SUCCEEDED REASON="manually run"
----删除
exec dbms_scheduler.drop_job('PATH_SIZE');
exec dbms_scheduler.drop_schedule('MY_SCHEDULE');
exec dbms_scheduler.drop_program('my_program_du');
6.设置Repeat Interval参数
Job 和Schedule中REPEAT_INTERVAL参数都是用来控制执行的频率或周期,虽然说周期是一个时间性概念,不过REPEAT_INTERVAL指定的时候并不是一个时间值,而是由一组关键字描述的时间。
除了前面介绍Job和Schedule的REPEAT_INTERVAL参数时,提到该参数拥有FREQ以及INTERVAL两个关键字,其实除此之外,还有如BYMONTH、BYWEEKNO、BYYEARDAY、BYDATE等等参数,可以用来进行更精确的定义,比如通过BYMONTH关键字指定调度运行的月份,BYDAY指定调度在哪天运行等等。
REPEAT_INTERVAL 参数的详细语法如下:
repeat_interval = regular_schedule | combined_schedule
==============================
regular_schedule = frequency_clause
[";" interval_clause] [";" bymonth_clause] [";" byweekno_clause]
[";" byyearday_clause] [";" bydate_clause] [";" bymonthday_clause]
[";" byday_clause] [";" byhour_clause] [";" byminute_clause]
[";" bysecond_clause] [";" bysetpos_clause] [";" include_clause]
[";" exclude_clause] [";" intersect_clause][";" periods_clause]
[";" byperiod_clause]
==============================
combined_schedule = schedule_list [";" include_clause]
[";" exclude_clause] [";" intersect_clause]
frequency_clause = "FREQ" "=" ( predefined_frequency | user_defined_frequency )
predefined_frequency = "YEARLY" | "MONTHLY" | "WEEKLY" | "DAILY" |
"HOURLY" | "MINUTELY" | "SECONDLY"
user_defined_frequency = named_schedule
==============================
interval_clause = "INTERVAL" "=" intervalnum
intervalnum = 1 through 99
bymonth_clause = "BYMONTH" "=" monthlist
monthlist = monthday ( "," monthday)*
month = numeric_month | char_month
numeric_month = 1 | 2 | 3 ... 12
char_month = "JAN" | "FEB" | "MAR" | "APR" | "MAY" | "JUN" |
"JUL" | "AUG" | "SEP" | "OCT" | "NOV" | "DEC"
byweekno_clause = "BYWEEKNO" "=" weeknumber_list
weeknumber_list = weeknumber ( "," weeknumber)*
weeknumber = [minus] weekno
weekno = 1 through 53
byyearday_clause = "BYYEARDAY" "=" yearday_list
yearday_list = yearday ( "," yearday)*
yearday = [minus] yeardaynum
yeardaynum = 1 through 366
bydate_clause = "BYDATE" "=" date_list
date_list = date ( "," date)*
date = [YYYY]MMDD [ offset | span ]
bymonthday_clause = "BYMONTHDAY" "=" monthday_list
monthday_list = monthday ( "," monthday)*
monthday = [minus] monthdaynum
monthdaynum = 1 through 31
byday_clause = "BYDAY" "=" byday_list
byday_list = byday ( "," byday)*
byday = [weekdaynum] day
weekdaynum = [minus] daynum
daynum = 1 through 53 /* if frequency is yearly */
daynum = 1 through 5 /* if frequency is monthly */
day = "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN"
byhour_clause = "BYHOUR" "=" hour_list
hour_list = hour ( "," hour)*
hour = 0 through 23
byminute_clause = "BYMINUTE" "=" minute_list
minute_list = minute ( "," minute)*
minute = 0 through 59
bysecond_clause = "BYSECOND" "=" second_list
second_list = second ( "," second)*
second = 0 through 59
bysetpos_clause = "BYSETPOS" "=" setpos_list
setpos_list = setpos ("," setpos)*
setpos = [minus] setpos_num
setpos_num = 1 through 9999
==============================
include_clause = "INCLUDE" "=" schedule_list
exclude_clause = "EXCLUDE" "=" schedule_list
intersect_clause = "INTERSECT" "=" schedule_list
schedule_list = schedule_clause ("," schedule_clause)*
schedule_clause = named_schedule [ offset ]
named_schedule = [schema "."] schedule
periods_clause = "PERIODS" "=" periodnum
byperiod_clause = "BYPERIOD" "=" period_list
period_list = periodnum ("," periodnum)*
periodnum = 1 through 100
==============================
offset = ("+" | "-") ["OFFSET:"] duration_val
span = ("+" | "-" | "^") "SPAN:" duration_val
duration_val = dur-weeks | dur_days
dur_weeks = numofweeks "W"
dur_days = numofdays "D"
numofweeks = 1 through 53
numofdays = 1 through 376
minus = "-"
这个语法形式看起来复杂无比,其实实用起来很简单,之所以看起来复杂,是因为其功能太过灵活,这里不准备逐条解释每一个语法细节,下面将着重通过一些常用设置
例如:设置任务仅在周5的时候运行:
REPEAT_INTERVAL => 'FREQ=DAILY; BYDAY=FRI';
REPEAT_INTERVAL => 'FREQ=WEEKLY; BYDAY=FRI';
REPEAT_INTERVAL => 'FREQ=YEARLY; BYDAY=FRI';
设置任务隔一周运行一次,并且仅在周5 运行:
REPEAT_INTERVAL => 'FREQ=WEEKLY; INTERVAL=2; BYDAY=FRI';
设置任务在当月最后一天运行:
REPEAT_INTERVAL => 'FREQ=MONTHLY; BYMONTHDAY=-1';
设置任务在3 月10 日运行:
REPEAT_INTERVAL => 'FREQ=YEARLY; BYMONTH=MAR; BYMONTHDAY=10';
REPEAT_INTERVAL => 'FREQ=YEARLY; BYDATE=0310';
设置任务每10 隔天运行:
REPEAT_INTERVAL => 'FREQ=DAILY; INTERVAL=10';
设置任务在每天的下午4、5、6 点时运行:
REPEAT_INTERVAL => 'FREQ=DAILY; BYHOUR=16,17,18';
设置任务在每月29 日运行:
REPEAT_INTERVAL => 'FREQ=MONTHLY; BYMONTHDAY=29';
设置任务在每年的最后一个周5 运行:
REPEAT_INTERVAL => 'FREQ=YEARLY; BYDAY=-1FRI';
设置任务每隔50 个小时运行:
REPEAT_INTERVAL => 'FREQ=HOURLY; INTERVAL=50';
注意:SCHEDULER 中的REPEAT_INTERVAL 也完全可以按照以前Job方式设置, REPEAT_INTERVAL实际上是指定周期,直接指定一个时间值,当然也是周期。
比如说,设置任务每天执行一次,也可以设置REPEAT_INTERVAL 参数值如下:
REPEAT_INTERVAL => 'trunc(sysdate)+1'
又比如设置任务每周执行一次:
REPEAT_INTERVAL => 'trunc(sysdate)+7'
不过需要注意,这种方式仅用于创建SCHEDULER 中jobs 时使用,不能用于schedule。
reference http://blog.youkuaiyun.com/tianlesoftware/article/details/4715218
http://blog.sina.com.cn/s/blog_4adc4b090101cgyx.html
http://blog.sina.com.cn/s/blog_4449f2f90100j63b.html
来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/30130773/viewspace-2121568/,如需转载,请注明出处,否则将追究法律责任。
转载于:http://blog.itpub.net/30130773/viewspace-2121568/