oracle 10g 创建job 相关-dbms_scheduler.create_job

grant create job to somebody;

 -- job 创建

 begin

 dbms_scheduler.create_job (

 job_name => 'AGENT_LIQUIDATION_JOB',

 job_type => 'STORED_PROCEDURE',

 job_action => 'AGENT_LIQUIDATION.LIQUIDATION', --存储过程名

 start_date => sysdate,

 repeat_interval => 'FREQ=MONTHLY; INTERVAL=1; BYMONTHDAY=1;BYHOUR=1;BYMINUTE=0;BYSECOND=0', -- 按月，间隔为1个(月),每月1号,凌晨1点

 comments => '执行代理商清分程序'

 );

 end;

 /

-- job 执行时间测试

 DECLARE

 start_date date;

 return_date_after date;

 next_run_date date;

 BEGIN

start_date := sysdate;--to_timestamp_tz('10-OCT-2004 10:00:00','DD-MM-YYYY HH24:MI:SS');

return_date_after := start_date;

FOR i IN 1..10 LOOP

 DBMS_SCHEDULER.EVALUATE_CALENDAR_STRING('FREQ=MONTHLY; INTERVAL=1; BYMONTHDAY=1;BYHOUR=1;BYMINUTE=0;BYSECOND=0',start_date, return_date_after, next_run_date);

 DBMS_OUTPUT.PUT_LINE('next_run_date: ' || to_char(next_run_date,'yyyy-mm-dd HH24:MI:SS'));

 return_date_after := next_run_date;

 END LOOP;

 END;

 /

-- job 查询

 select owner, job_name, state from dba_scheduler_jobs;

 select job_name, state from user_scheduler_jobs;

-- job 启用

 begin

 dbms_scheduler.enable('BACKUP_JOB');

 end;

 /

-- job 运行

 begin

 dbms_scheduler.run_job('COLA_JOB',TRUE); -- true代表同步执行

 end;

 /

-- job 停止(不太好用)

 begin

 dbms_scheduler.stop_job(job_name => 'COLA_JOB',force => TRUE);

 end; 

/

 -- job 删除(对停job来说好用)

 begin

 dbms_scheduler.drop_job(job_name => 'COLA_JOB',force => TRUE);)

 end;

 /

下面详细讲解：

 1.创建job

 job是什么呢? 简单的说就是计划(schedule)加上任务说明. 另外还有一些必须的参数.

 这里提到的"任务"可以是数据库内部的存储过程,匿名的PL/SQL块,也可以是操作系统级别的脚本.

可以有两种方式来定义"计划":

 1) 使用DBMS_SCHDULER.CREATE_SCHEDULE 定义一个计划;

 2) 调用DBMS_SCHDULER.CREATE_JOBE过程直接指定 (下面会详细说明)

 在创建一个计划时，你至少需要指定下面的属性，它们是job运行所必须的:

 开始时间 (start_time);

 重复频率 (repeat_interval);

 结束时间 (end_time)

另外，对于一个job而言，还有很多的附加参数:

 job_class

 job_priority

 auto_drop

 restartable

 max_runs

 max_failures

 schedule_limit

 logging_level

  下面，我以问答的形式来具体解释.

 Q1:怎么从数据库中查询job的属性 ?

 A1: 有两种方法:

 1) 查询(DBA|ALL|USER)_SCHEDULER_JOBS 视图

 (提示: 根据用户权限的不同，选择性的查询 DBA|ALL|USER视图)

 2) 调用DBMS_SCHEDULER包中的GET_ATTRIBUTE 过程

 Q2: 怎么设置这些属性呢?

A2: 也是有两种方法

 

1) 在创建job时直接指定

2) 调用DBMS_SCHEDULER包中的SET_ATTRIBUTE 过程

Q3: "我需要什么权限才能创建job" ?

它可以创建属主为任何用户(SYS用户除外)的job.

 缺省情况下,job会被创建在当前的schema下，并且是没有激活的; 如果要使job一创建

 就自动激活，需要显式的设置enabled 属性为true, 来看一个例子:

 begin

 dbms_scheduler.create_job

 (

 job_name => 'ARC_MOVE',

 schedule_name => 'EVERY_60_MINS',

 job_type => 'EXECUTABLE',

 job_action => '/home/dbtools/move_arcs.sh'

 enabled => true,

 comments => 'Move Archived Logs to a Different Directory'

 );

 end;

 /

 Q4: 能不能详细地讲述一下上面这个过程用到的各个参数?

 A4:

 job_name: 顾名思义,每个job都必须有一个的名称

 schedule_name: 如果定义了计划，在这里指定计划的名称

 job_type: 目前支持三种类型:

 PL/SQL块: PLSQL_BLOCK,

 存储过程: STORED_PROCEDURE

 外部程序: EXECUTABLE (外部程序可以是一个shell脚本,也可以是操作系统级别的指令).

 job_action: 根据job_type的不同，job_action有不同的含义.

 如果job_type指定的是存储过程，就需要指定存储过程的名字;

 如果job_type指定的是PL/SQL块，就需要输入完整的PL/SQL代码;

 如果job_type指定的外部程序，就需要输入script的名称或者操作系统的指令名

 enabled: 上面已经说过了，指定job创建完毕是否自动激活

 comments: 对于job的简单说明

 2. 指定job的执行频率

 如果我们创建了一个job,并且希望它按照我们指定的日期和时间来运行，就需要定义job的重复频度了. 例如每天运行，每周日的22:00运行, 每周一,三,五运行，每年的最后一个星期天运行等等.

(说明:10G以前的版本，与操作系统的交互方面，实现的不是很好。例如要实现一个定期的rman备份任务，就需要结合OS的命令来实现,在UNIX下可以用crontab实现，在windows下用AT命令来实现)

 10G 在这方面有了很大的增强，因为创建job时可以直接指定操作系统的命令或者脚本，再合理的定义job的执行频率,可以很轻松地完成复杂的调度任务.

 10G 支持两种模式的repeat_interval,一种是PL/SQL表达式，这也是dbms_job包中所使用的,例如SYSDATE+1, SYSDATE + 30/24*60; 另一种就是日历表达式。

 例如MON表示星期一,SUN表示星期天,DAY表示每天,WEEK表示每周等等. 下面来看几个使用日历表达式的例子：

 repeat_interval => 'FREQ=HOURLY; INTERVAL=2'

每隔2小时运行一次job

 repeat_interval => 'FREQ=DAILY'

 每天运行一次job

 repeat_interval => 'FREQ=WEEKLY; BYDAY=MON,WED,FRI"

 

 每周的1,3,5运行job

 repeat_interval => 'FREQ=YEARLY; BYMONTH=MAR,JUN,SEP,DEC; BYMONTHDAY=30'

 每年的3,6,9,12月的30号运行job

 用过crontab的人应该都有种似曾相识的感觉吧，呵呵

 下面再说说使用日历表达式的规则:

日历表达式基本分为三部分:第一部分是频率，也就是"FREQ"这个关键字，它是必须指定的; 第二部分是时间间隔，也就是"INTERVAL"这个关键字，取值范围是1-999. 它是可选的参数; 最后一部分是附加的参数,可用于精确地指定日期和时间,它也是可选的参数,例如下面这些值都是合法的:

BYMONTH,BYWEEKNO,BYYEARDAY,BYMONTHDAY,BYDAY

BYHOUR,BYMINUTE,BYSECOND

 详细的参数说明请参考 dbms_scheduler的使用说明.

 既然说到了repeat_interval,你可能要问:"有没有一种简便的方法来得出，或者说是评估出job的每次运行时间，以及下一次的运行时间呢?"

 dbms_scheduler包提供了一个过程evaluate_calendar_string,可以很方便地完成这个需求. 来看下面的例子:

 SQL> set serveroutput on size 999999

 SQL> declare

 L_start_date TIMESTAMP;

 l_next_date TIMESTAMP;

 l_return_date TIMESTAMP;

begin

l_start_date := trunc(SYSTIMESTAMP);

l_return_date := l_start_date;

for ctr in 1..10 loop

dbms_scheduler.evaluate_calendar_string(

'FREQ=DAILY; BYDAY=MON,TUE,WED,THU,FRI; BYHOUR=7,15',

l_start_date, l_return_date, l_next_date

);

dbms_output.put_line('Next Run on: ' ||

to_char(l_next_date,'mm/dd/yyyy hh24:mi:ss')

);

l_return_date := l_next_date;

end loop;

end;

/

输出结果如下:

Next Run on: 03/22/2004 07:00:00

Next Run on: 03/22/2004 15:00:00

Next Run on: 03/23/2004 07:00:00

Next Run on: 03/23/2004 15:00:00

Next Run on: 03/24/2004 07:00:00

Next Run on: 03/24/2004 15:00:00

Next Run on: 03/25/2004 07:00:00

Next Run on: 03/25/2004 15:00:00

Next Run on: 03/26/2004 07:00:00

Next Run on: 03/26/2004 15:00:00