ORACLE DBMS_SCHEDULER使用

在Oracle10g里面，已经不赞成使用DBMS_JOB，推荐使用DBMS_SCHEDULER，它的健壮为调度提供更好的规划和结构。下面我只简单写一个例子。 
begin 
    DBMS_SCHEDULER.CREATE_PROGRAM( 
   >     program_type => 'STORED_PROCEDURE', 
   >     number_of_arguments => 0, 
   >     comments => '定时调度测试' 
    ); 
end; 
program_name:program的名字 
program_type:program的类型。STORED_PROCEDURE存储过程 
program_action:要执行的程序。guozhwTest 存储过程的名字

 

 

举例如下：

BEGIN
      DBMS_SCHEDULER.CREATE_PROGRAM (
        >          program_action          => 'PKG_SCHEDULER.CREATEDUNDATA',
        >          enabled                 => FALSE,
     number_of_arguments     => 5,
     comments            => '生成催缴数据'     
     );

  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT(PROGRAM_NAME      => 'PRM_CREATEDUNDATA',
                                         ARGUMENT_POSITION => 1,
                                         ARGUMENT_NAME     => 'I_BILLINGCYCLEID',
                                         ARGUMENT_TYPE     => 'VARCHAR2',
                                         DEFAULT_VALUE     => NULL,
                                         OUT_ARGUMENT      => FALSE);
                                         
  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT(PROGRAM_NAME      => 'PRM_CREATEDUNDATA',
                                         ARGUMENT_POSITION => 2,
                                         ARGUMENT_NAME     => 'I_BUSINESSTYPE',
                                         ARGUMENT_TYPE     => 'VARCHAR2',
                                         DEFAULT_VALUE     => NULL,
                                         OUT_ARGUMENT      => FALSE);

  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT(PROGRAM_NAME      => 'PRM_CREATEDUNDATA',
                                         ARGUMENT_POSITION => 3,
                                         ARGUMENT_NAME     => 'I_STATE',
                                         ARGUMENT_TYPE     => 'VARCHAR2',
                                         DEFAULT_VALUE     => NULL,
                                         OUT_ARGUMENT      => FALSE);
                                         
  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT(PROGRAM_NAME      => 'PRM_CREATEDUNDATA',
                                         ARGUMENT_POSITION => 4,
                                         ARGUMENT_NAME     => 'I_BANKCODE',
                                         ARGUMENT_TYPE     => 'VARCHAR2',
                                         DEFAULT_VALUE     => NULL,
                                         OUT_ARGUMENT      => FALSE);

  DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT(PROGRAM_NAME      => 'PRM_CREATEDUNDATA',
                                         ARGUMENT_POSITION => 5,
                                         ARGUMENT_NAME     => 'I_OPERATORCODE',
                                         ARGUMENT_TYPE     => 'VARCHAR2',
                                         DEFAULT_VALUE     => NULL,
                                         OUT_ARGUMENT      => FALSE);

  DBMS_SCHEDULER.ENABLE(NAME => 'PRM_CREATEDUNDATA');
  COMMIT;
END;

 

 

 

之后就可以在select * from sys.USER_SCHEDULER_PROGRAMS t中看到program了

 

 

 

×××××××××××××××××××××××××××××××××××××××××***********************************************************

最近遇到一个CASE，要做定时任务，想来想去，还是先看看Oracle提供了啥.. 
Oracle10g引入了一种新的作业调度程序：dbms_scheduler，通过如下命令可以查看它包含一些什么功能， 
SQL>> COMMIT; 
--sys.dbms_lock.sleep(120); 
end>                 start_date => '27-8月 -07 12.00.00.000 上午', 
               >                 end_date => '28-8月 -07 12.00.00.000 上午', 
               > end; 
这里需要注意的是，参数start_date和end_date都是TIMESTAMP 类型，在输入的时候要遵循它们的格式， 
往往doc里面的格式都是英文环境下的，这个时候你要通过查询字典nls_database_parameters或者 
select> 每小时运行一次 
repeat_interval => 'FREQ=DAILY INTERVAL=1' 
每天运行一次 
更详细的说明，要查询doc。另外它还有一个过程dbms_scheduler.evaluate_calendar_string是估算下一次运行的时间的。 
第二步，创建一个program 
/************************************************************* 
* Program Administration Procedures 
************************************************************* 
*/ 
-- Program>                 program_type => 'PLSQL_BLOCK', 
               >                 number_of_arguments => 0, 
               >                 comments => 'comments'); 
end; 
这里需要注意的是program_type,如果你要运行PLSQL块，则选择PLSQL_BLOCK，如果是sh脚本，则'EXECUTABLE'。 
这里我选择PLSQL块。 
第三步创建一个job 
-->             program_name => 'your program_name', 
            schedule_name => 'your>             enabled => true, 
            auto_drop =>> end; 
这样就完成了一个job的创建，下面就是运行它： 
begin 
-- Call>             use_current_session => 'false'); 
end; 
use_current_session 这个参数要定义为false，它才能在后台运行。 
创建以后的监控： 
查看调度 
SELECT * FROM User_Scheduler_Schedules; 
查看作业 
SELECT * FROM User_Scheduler_Jobs; 
查看程序 
SELECT * FROM User_Scheduler_Programs; 
查看执行中的作业，也就是PRO_TEST在运行阶段的作业。前面的过程中，我定义了一个sys.dbms_lock.sleep(120); 
实际就是为了查看这个视图。 
SELECT * FROM User_Scheduler_Running_Jobs; 
查看job的日志 
SELECT * FROM User_Scheduler_Job_Log; 
如果日志中有FAILeD的状态，那么就要查看altersid.log了。 
好了，一个基本的调度例子就完成了。如果想更详细的了解它，请阅读该包头的注释，和查阅相关DOC 
Oracle® Database 
PL/SQL Packages and Types Reference 
10g Release 2 (10.2) 
在9i的时候，job有一个烦人的问题，就是延时，一个job的执行耗时是10分钟，inteval为1天，第一次执行为晚上12点， 
在以后的执行过程中，该job为逐渐按10分钟递增时间。10g的Scheduler解决了这个问题，但是我还是发现Scheduler同样无法异步的执行，我的inteval是1分钟，但在程序中如果打开 
sleep(120)后，实际inteval就变成了120秒...它还是和job一样，必须等待上一次任务的完成，这样也没有达到我的初衷。 
最后，我也应用中是否最终会使用Scheduler，还有待测试。除了Scheduler，在中间层，如EJB和Spring....

 

 

 

 

part 1

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" ?

A3: 你至少需要create_job这个系统权限。如果用户拥有create> schedule_name => 'EVERY_60_MINS',
job_type => 'EXECUTABLE',
job_action => '/home/dbtools/move_arcs.sh',
enabled =>> );
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

详细的参数说明请参考> l_return_date := l_start_date;
for> l_start_date, l_return_date, l_next_date
);

dbms_output.put_line('Next Run>
end>3. 创建程序 (program)

什么是程序? 我的理解就是准备计划需要的元数据(metadata),它
包括以下部分:

程序名;

程序中用到的参数: 例如程序的类型，以及具体操作的描述

来看一个例子
begin
dbms_scheduler.create_program(
program_name=> 'DAILY_BACKUP_SH',
program_type=> 'EXECUTABLE',
program_action=> '/home/oracle/script/daily_backup.sh');
end;
/

这个例子将会创建一个名为"DAILY_BACKUP_SH"的程序，类型是可执行的shell脚本，脚本的名称是“/home/oracle/script/daily_backup.sh”


Q1: 程序和作业相比，有什么区别呢?

A1: 程序其实是可以与作业分离的，因此不同的用户可以在不同的时间段去重用它.而一个作业是属于特定的用户的;

另外，将程序与作业分离，也就激活了一个新的程序库(Program Library),利用程序库,用户可以很自由地选择特定的程序在特定的时间段运行，以及自由的配置程序执行时的参数.


Q2: 能否解释一下> program_type => 'PLSQL_BLOCK',

program_action => 'DECLARE
sUsername>
BEGIN

OPEN> program_action=> 'LEO.UPDATE_SCHEMA_STATUS');
program_type=> 'STORED_PROCEDURE',
number_of_arguments => 1,
enabled => TRUE);

dbms_scheduler.define_program_argument(
program_name=> 'UPDATE_STATS_2',
argument_name => 'SCHEMA_NAME',
argument_position => 1,
argument_type => 'varchar2',
default_value => 'HR');
end;
/

这个例程是不是很像上面的那个例子呢? 对,它们的区别只是
在这个例子中,程序的类型是存储过程，而不是pl/sql块.

解释:
使用define_program_argument这个过程来定义一个程序所需要的参数. 有两点说明一下:

1) 程序如果使用了参数，就必须事先指定，这样才能在程序被job使用时生效;

2) 定义程序的参数不会改变程序的激活属性。也就是说，如果一个程序是没有激活的状态,运行了define_program_argument过程不会自动激活这个程序.


关于权限:
缺省情况下只有program的owner才能修改创建的程序，如果用户被授予了alter 权限 或者> program_name=> 'leo.UPDATE_STATS_2',
start_date=>'2005-06-20 11:00.00.000000 PM +8:00',
repeat_interval=>'FREQ=MONTHLY;INTERVAL=1',
end_date=>'2006-06-20 11:00.00.000000 PM +8:00',
comments=>'Monthly>

一些补充

1.在10G R2 中, 如果用dbms_scheduler创建的job的类型为executable, 需要create external job 权限。

2. 在使用create_job或者create_schedule前，请先检查
NLS_DATE_LANGUAGE, NLS_DATE_FORMAT, 
NLS_TIMESTAMP_FORMAT, NLS_TIMESTAMP_TZ_FORMAT
等参数的值, 通过alter> alter session set NLS_DATE_FORMAT='dd-mm-yyyy hh24:mi:ss';
alter>
begin
dbms_scheduler.create_job(
job_name=> 'zip_emlog',
job_type=> 'EXECUTABLE',
job_action =>'/home/leo/zip_log.sh',
enabled=>true,
start_date=>'03-07-2005 9:30:00 PM + 8:00',
repeat_interval=>'FREQ=MINUTELY;INTERVAL=30',
end_date=>'31-07-2005 9:30:00 PM + 8:00',
comments=>'Get a latest em log copy and compress it every 30 minutes');
end;
/