oracle scheduler（一）创建…

      JOBS，其实就是Scheduler 管理的一个(或多个)任务的执行调度。

1.1 创建Jobs

       通过DBMS_SCHEDULER 包来创建Jobs，是使用其CREATE_JOB 过程。在创建Job 时，用户可以指定要执行的任务，调度信息(什么时候执行，执行周期，终止日期等)以及其它一些任务相关的属性。例如：

create table TEST (id number);

CREATE OR REPLACE PROCEDURE IT

AS

BEGIN

insert into TEST VALUES(1);

END;

 

SQL> BEGIN

DBMS_SCHEDULER.CREATE_JOB (

job_name => 'JobTest',

job_type => 'STORED_PROCEDURE',

job_action => 'SYSTEM.IT',

start_date => sysdate,

repeat_interval => 'FREQ=MINUTELY;INTERVAL=10');

END;

/

       事实上，有权限的话，用户也可以创建其它SCHEMA 下的JOB，只需要在指定JOB_NAME 时，按照schema.job_name 的格式即可。这种情况下创建的JOB，其CREATED 与OWNER 有可能并不相同。当使用CREATE_JOB 过程创建JOB 时，可指定的参数值很多，只不过多数情况下用户仅指定部分参数即可满足需求。

其中，上例中指定的参数，分别代表的含义如下：

JOB_NAME：指定任务的名称，必选值，注意要确保指定的名称唯一。

JOB_TYPE：任务执行的操作类型，必选值，有下列几个可选值：

（1） PLSQL_BLOCK：表示任务执行的是一个PL/SQL 匿名块。

（2）STORED_PROCEDURE：表示任务执行的是ORACLE 过程(含PL/SQL PROCEDURE 和JAVA PROCEDURE)，本例中正是指定这一参数值。

（3）EXECUTABLE：表示任务执行的是一个外部程序，比如说操作系统命令。

（4）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 两个关键字。

（1）FREQ 关键字用来指定间隔的时间周期，可选参数有：YEARLY, MONTHLY, WEEKLY, DAILY,HOURLY, MINUTELY, and SECONDLY，分别表示年、月、周、日、时、分、秒等单位。

（2）INTERVAL 关键字用来指定间隔的频繁，可指定的值的范围从1-99。

例如：REPEAT_INTERVAL=>'FREQ=DAILY;INTERVAL=1';表示每天执行一次，如果将INTERVAL 改为7 就表示每7 天执行一次，效果等同于FREQ=WEEKLY;INTERVAL=1。

    一般来说，使用DBMS_SCHEDULER.CREATE_JOB 创建一个JOB，至少需要指定上述参数中的前3 项。除此之外，还可以在CREATE_JOB 时，指定下列参数：

（1）NUMBER_OF_ARGUMENTS：指定该JOB 执行时需要附带的参数的数量，默认值为0，注意当JOB_TYPE 列值为PL/SQL_BLOCK 或CHAIN 时，本参数必须设置为0，因为上述两种情况下不支持附带参数。

（2）END_DATE：指定任务的过期时间，默认值为NULL。任务过期后，任务的STATE 将自动被修改为COMPLETED，ENABLED 被置为FALSE。如果该参数设置为空的话，表示该任务永不过期，将一直按照REPEAT_INTERVAL 参数设置的周期重复执行，直到达到设置的MAX_RUNS 或MAX_FAILURES 值。

（3）JOB_CLASS：指定任务关联的CLASS，默认值为DEFAULT_JOB_CLASS。

（4）ENABLED：指定任务是否启用，默认值为FALSE。FALSE 状态表示该任务并不会被执行，除非被用户手动调用，或者用户将该任务的状态修改为TRUE。

（5）AUTO_DROP：当该标志被置为TRUE 时，ORACLE 会在满足条件时自动删除创建的任务

       1）任务已过期；

       2）任务最大运行次数已达MAX_RUNS 的设置值；

       3）任务未指定REPEAT_INTERVAL 参数，仅运行一次；

     该参数的默认值即为TRUE。用户在执行CREATE_JOB 过程时可以手动将该标志指定为FALSE，当参数值设置为FALSE 时，即使满足上述提到的条件任务也不会被自动删除，这种情况下，唯一能够导致任务被删除的情况，就是用户主动调用DROP_JOB 过程。

（6）COMMENTS：设置任务的注释信息，默认值为NULL。

    上面的例子创建了一个新的JOB，不过这个JOB 与普通JOB 不同，此时查询USER_JOBS 视图是查不到刚刚创建的JOB 的信息，因为这个JOB 是SCHEDULER 管理的JOB。要查询SCHEDULER 管理的JOBS，应该通过user_scheduler_jobs(all_scheduler_jobs，dba_scheduler_jobs也可以 )， 例如：

SQL> 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

---------- ---------------- ---------- ---------- ------------------------- ------ ------

JOBTEST    STORED_PROCEDURE SYSTEM.IT  2009-09-25 FREQ=MINUTELY;INTERVAL=10  FALSE DISABLED

    注意：JOB 虽然成功创建了，但却并未执行.因为ENABLED 参数当不显式指定时，该参数的默认值为false。

1.2 管理Jobs

1.2.1 启用Jobs

       前面创建JOB 时，由于未显式的指定ENABLED 参数，因此即使指定了START_DATE，默认情况下JOB不会自动执行。对于这种情况，DBMS_SCHEDULER 包中提供了一个过程ENABLE，可以用来修改JOB 的启用状态，调用方式非常简单，例如：

SQL> exec dbms_scheduler.enable('JOBTEST');

PL/SQL procedure successfully completed.

1.2.2 禁用Jobs

       DBMS_SCHEDULER.ENABLE 仅用来将JOB(其实不仅仅对JOB 有效，对于CHAIN、PROGRAM 等也有效)的启用状态置为TRUE。如果想将其启用状态置为FALSE，还有一个与该功能对应的过程：DBMS_SCHEDULER.DISABLE，如：

SQL> exec dbms_scheduler.disable('JOBTEST');

PL/SQL procedure successfully completed.

 
这两个过程仅用来重置对象的状态，因此均可以无限次执行，即使执行时对象已经被置为要指定的状态。

1.2.3 修改Jobs

       由于JOB 的属性众多，难免可能会遇到需要修改的情况，比如说前面创建JOB 时不小心，指定要执行的过程名输入错误(CREATE_JOB 在创建时不会自动检查指定的过程是否有效)，这种情况下就必然涉及到对JOB 的修改(或者说重定义)，DBMS_SCHEDULER 包中专门提供了一个过程SET_ATTRIBUTE，可以用来修改任务的属性值。

例如，修改刚刚创建的JOB：INSERT_TEST_TBL 执行的过程，执行语句如下：

SQL> exec dbms_scheduler.set_attribute('JobTest','JOB_ACTION','SYSTEM.IT');

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：记录任务所有相关信息，不仅有任务的运行情况，甚至连任务的创建、修改等也均将记入日志。

       提示： 查看scheduler 管理的job ， 可以通过user_scheduler_job_log 和user_scheduler_job_run_details 两个视图中查询。

（2） RESTARTABLE：指定jobs 运行出错后，是否能够适时重启。创建任务时如未明确指定，本参数默认情况下设置为FALSE，如果设置为TRUE，就表示当任务运行时出错，下次运行时间点到达时仍会启动，并且如果运行仍然出错，会继续重新运行，不过如果连接出错达到6 次，该job 就会停止。

（3） MAX_FAILURES：指定jobs 最大连续出错次数。该参数值可指定的范围从1-1000000，默认情况下该参数设置为NULL，表示无限制。达到指定出错次数后，该job 会被自动disable。

（4） MAX_RUNS：指定jobs 最大运行次数，该参数值可指定的范围从1-1000000，默认情况下该参数设置为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，则表示由系统创建。

1.2.4 执行Jobs

     虽然说jobs 大多都应该是自动执行，不过经过前面的示例看出，并不是说创建了jobs 它就会自动执行，是否能够真正自动执行由jobs 自身的多个相关属性决定。

     可以使用DBMS_SCHEDULER 包手动调用jobs并执行。如：

SQL> exec dbms_scheduler.run_job('JOBTEST');

PL/SQL procedure successfully completed

     jobs 每执行一次，无论成功或失败，均会在*_scheduler_job_log 中生成一条对应的记录(前提是logging_level 属性值未设置为dbms_scheduler.logging_off) ， 同时， 用户也可以通过*_scheduler_job_run_details 视图查询job 执行的详细信息。


1.2.5 停止Jobs

       停止job 可以使用DMBS_SCHEDULER.STOP_JOB 过程，例如：

SQL> exec dbms_scheduler.stop_job('JOBTEST');

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"'。

1.2.6 删除Jobs

       删除创建的job 就比较简单了，直接执行dbms_scheduler.drop_job 过程即可，例如：

SQL> exec dbms_scheduler.drop_job('JOBTEST');

PL/SQL procedure successfully completed

    删除jobs 并不是修改该job 中某个字段的标记值，而是直接删除其在数据字典中的字义，因此被删除的job如果未来发现仍然需要，只能重建，而无法通过其它方式快速恢复。不过，删除jobs 的操作，并不会级联删除这些job 曾经执行过的日志信息。

转自：http://blog.csdn.net/tianlesoftware/article/details/4715218