Oracle定时任务(1)-DBMS_SCHEDULER

定义如何记录log到dba_scheduler_job_log/dba_scheduler_job_run_details视图。
可用选项如下，是些预定义的常量。
需要注意，实际上的logging level还取决job所属的job_class, 取两者中的最高值。
例如创建job的时候如果不指定job class，默认是DEFAULT_JOB_CLASS，
而DEFAULT_JOB_CLASS的默认logging level是DBMS_SCHEDULER.LOGGING_RUNS,
所以创建的job的logging level至少是LOGGING_RUNS。
1) DBMS_SCHEDULER.LOGGING_OFF 不记录
2) DBMS_SCHEDULER.LOGGING_FAILED_RUNS 只记录失败的job运行
3) DBMS_SCHEDULER.LOGGING_RUNS 记录每次job运行
4) DBMS_SCHEDULER.LOGGING_FULL 不仅记录每次job运行，还包括针对job的任何操作。

max_failures
默认为null,即没有限制。

max_runs
默认为null,即没有限制。

restartable
job执行失败后是否retry，默认为false。 
当设置为true,执行失败1秒后进行第一次retry, 然后是10秒，100秒，每次时间间隔乘10。
最多执行6次retry（大概30小时后）。如果时间超过了下次正常的计划执行的时间，停止retry过程。
对于retry,*_scheduler_jobs视图中的RUN_COUNT, FAILURE_COUNT 不会增加。

此外，repeat_interval，start_date，end_date等都可以设置。

 

 

参数说明
1）schedule_name,program_name,job_name
这些名字在整个sql名字空间内必须唯一。比如,job_name不能和某个表名相同。

2）repeat_interval
定义job的计划，可以指定的形式相当丰富，也相当灵活，很强大。
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]

frequency_clause = "FREQ" "=" "YEARLY" | "MONTHLY" | "WEEKLY" | "DAILY" | 
   "HOURLY" | "MINUTELY" | "SECONDLY"

interval_clause = "INTERVAL" "=" 1 through 99

bymonth_clause = "BYMONTH" "=" {month ( "," month)*}
   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 ( "," weeknumber)*}
   weeknumber = [minus] 1 through 53

byyearday_clause = "BYYEARDAY" "=" {yearday ( "," yearday)*}
   yearday = [minus] 1 through 366
   
bydate_clause = "BYDATE" "=" {date ( "," date)*}
   date = [YYYY]MMDD [ offset | span ]

bymonthday_clause = "BYMONTHDAY" "=" {monthday ( "," monthday)*}
   monthday = [minus] 1 through 31

byday_clause = "BYDAY" "=" {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 ( "," hour)*}
   hour = 0 through 23
   
byminute_clause = "BYMINUTE" "=" {minute ( "," minute)*}
   minute = 0 through 59
 
bysecond_clause = "BYSECOND" "=" {second ( "," second)*}
   second = 0 through 59
   
bysetpos_clause = "BYSETPOS" "=" {setpos ("," setpos)*}
   setpos = [minus] 1 through 9999

include_clause = "INCLUDE" "=" schedule_list
exclude_clause = "EXCLUDE" "=" schedule_list
intersect_clause = "INTERSECT" "=" schedule_list
periods_clause = "PERIODS" "=" periodnum
byperiod_clause = "BYPERIOD" "=" {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 = "-"

举几个例子
a) 05/02 和 09/22 的 8:00 a.m., 1:00 p.m., 6:00 p.m.
‘freq=daily;byhour=8,13,18;byminute=0;bysecond=0;bydate=0502,0922‘

b) 每个月的最后一个工作日（注意,INTERVAL如果不指定,默认为1）
‘FREQ=MONTHLY;BYDAY=MON,TUE,WED,THU,FRI;BYSETPOS=-1‘

c) 1/10开始的5天，即1/10~1/14
BYDATE=0110+SPAN:5D
+表示从指定日期开始;-表示到指定日期结束;
^表示围绕指定日期的n天，如果n为偶数，调整为n+1。

d) 以下三种表示方法等同
BYDATE=0205-OFFSET:2W
BYDATE=0205-14D (the OFFSET: keyword is optional)
BYDATE=0122

3）start_date
实际上是schedule生效的日期，
对于一个定时执行的schedule,实际上的开始日期取决于repeat_interval参数。
如果start_date为null,等同于job被enable的时刻。

Oracle取start_date来作为repeat_interval的default值。
例如，如果指定start_date为1/31/2010 9:45:58，指定repeat_interval为‘FREQ=YEARLY‘，
等同于‘freq=yearly;bymonth=1;bymonthday=31;byhour=9;byminute=45;bysecond=58‘

不能给repeat_interval指定时区信息，Oracle取start_date的时区信息作为指定的时区。

4）end_date
这个时间之后，job将不再被执行。

5）program_type/program_action/number_of_arguments/job_type/job_action
program_type有三种形式
-‘PLSQL_BLOCK‘
program_action是一个PL/SQL block. 不支持参数，number_of_arguments必须为0.
必须以分号结尾。例如以下三种形式
‘my_proc();‘
‘BEGIN my_proc(); END;‘
‘DECLARE arg pls_integer:= 10; BEGIN my_proc2(arg); END;‘

-‘STORED_PROCEDURE‘
program_action是一个存储过程，注意不支持INOUT or OUT参数，也不支持function.
参数最多255个，可以通过SET_JOB_ARGUMENT_VALUE过程来设定。
例如‘"Schema"."Procedure"‘.

-‘EXECUTABLE‘
program_action是一个外部操作系统的命令行程序，包含完整路径，不能带任何命令行参数。
开始的‘?‘会被替换为oracle home目录;‘@‘会被替换为当前oracle实例的SID。

job_type类似于program_type，只是多了‘CHAIN‘这种类型来创建任务链。
 
6) enabled
如果为TRUE, 创建时候检查program/job有效性，如果通过检查把program/job置为ENABLED.
在program/job使用前必须通过ENABLE过程把它置为ENABLED。
如果program为disabled，仅仅enable一个job，那么job会按计划执行，但是会失败。

7）auto_drop
如果为TRUE, 在job完成之后或者被自动disabled之后job将被自动删除。
如果满足以下条件，job被视为完成。
a) 过了end_date。
b) 达到了最大运行次数（max_runs,可以通过SET_ATTRIBUTE来指定）
c) 非重复任务，即只运行一次的任务，并且已经运行了1次。
如果满足以下条件，job被视为自动disabled.
a) 达到了最大运行失败次数（max_failures,可以通过SET_ATTRIBUTE来指定）

相关数据字典
1) dba_scheduler_jobs/user_scheduler_jobs
Enabling 一个 disabled 状态的job会重设本视图中的RUN_COUNT, FAILURE_COUNT and RETRY_COUNT.

2) dba_scheduler_programs/user_scheduler_programs

3) dba_scheduler_schedules/user_scheduler_schedules
 
4) dba_scheduler_job_log/dba_scheduler_job_run_details

5) dba_scheduler_job_classes

6) 默认情况下，数据库自身定义了一个PURGE_JOB的任务。
该任务每天凌晨3点钟启动，清除30天前所产生的任务日志。

检验运行时间

dbms_scheduler提供了一个过程可以很方便的检验指定的计划(repeat_interval)。
DBMS_SCHEDULER.EVALUATE_CALENDAR_STRING (
   calendar_string    IN  VARCHAR2,
   start_date         IN  TIMESTAMP WITH TIME ZONE,
   return_date_after  IN  TIMESTAMP WITH TIME ZONE,
   next_run_date      OUT TIMESTAMP WITH TIME ZONE);

下面创建一个过程evaluate_repeat_interval，
传入repeat_interval字符串和计算的次数，会把每次的执行时间打印出来。

[sql] view plain copy  

1. create or replace procedure evaluate_repeat_interval(  
2.   p_repeat_interval in varchar2,  
3.   p_number_of_evaluation in int,  
4.   p_start_date in timestamp with time zone default sysdate  
5. )   
6. as  
7.   l_return_date_after timestamp with time zone;  
8.   l_next_run_date  timestamp with time zone;  
9. begin  
10.   l_return_date_after := p_start_date;  
11.   for i in 1..p_number_of_evaluation loop  
12.     dbms_scheduler.evaluate_calendar_string(  
13.       calendar_string=>p_repeat_interval,  
14.       start_date=>p_start_date,  
15.       return_date_after=>l_return_date_after,  
16.       next_run_date=>l_next_run_date);  
17.     dbms_output.put_line(l_next_run_date);  
18.     l_return_date_after := l_next_run_date;  
19.   end loop;  
20. end;  
21.   
22. --调用的例子1：每个月的最后一天  
23. begin  
24. evaluate_repeat_interval(  
25.   p_repeat_interval=>‘FREQ=MONTHLY;BYMONTHDAY=-1‘,  
26.   p_number_of_evaluation=>3,  
27.   p_start_date=>to_timestamp_tz(‘2012-01-01 00:00:00.000 +08:00‘,  
28.     ‘yyyy-mm-dd hh24:mi:ss.ff tzh:tzm‘)  
29.   );  
30. end;  
31. --执行结果  
32. <p>31-JAN-12 12.00.00.000000 AM +08:00  
33. 29-FEB-12 12.00.00.000000 AM +08:00  
34. 31-MAR-12 12.00.00.000000 AM +08:00</p><p>PL/SQL procedure successfully completed.</p>  
35. --调用的例子2：每个月的最后一个工作日  
36. begin  
37. evaluate_repeat_interval(  
38.   p_repeat_interval=>‘FREQ=MONTHLY;BYDAY=MON,TUE,WED,THU,FRI;BYSETPOS=-1‘,  
39.   p_number_of_evaluation=>3,  
40.   p_start_date=>to_timestamp_tz(‘2012-01-01 00:00:00.000 +08:00‘,  
41.     ‘yyyy-mm-dd hh24:mi:ss.ff tzh:tzm‘)  
42.   );  
43. end;  
44. --执行结果  
45. <p>31-JAN-12 12.00.00.000000 AM +08:00  
46. 29-FEB-12 12.00.00.000000 AM +08:00  
47. 30-MAR-12 12.00.00.000000 AM +08:00</p><p>PL/SQL procedure successfully completed.</p>  

Oracle定时任务(1)-DBMS_SCHEDULER

标签：