原文：Oracle job procedure 存储过程定时任务

oracle job有定时执行的功能，可以在指定的时间点或每天的某个时间点自行执行任务。

 

一、查询系统中的job，可以查询视图

 

--相关视图
select * from dba_jobs;
select * from all_jobs;
select * from user_jobs;
-- 查询字段描述
/*
字段（列）          类型                 描述
JOB                NUMBER          任务的唯一标示号
LOG_USER           VARCHAR2(30)    提交任务的用户
PRIV_USER          VARCHAR2(30)    赋予任务权限的用户
SCHEMA_USER        VARCHAR2(30)    对任务作语法分析的用户模式
LAST_DATE          DATE            最后一次成功运行任务的时间
LAST_SEC           VARCHAR2(8)     如HH24:MM:SS格式的last_date日期的小时，分钟和秒
THIS_DATE          DATE            正在运行任务的开始时间，如果没有运行任务则为null
THIS_SEC           VARCHAR2(8)     如HH24:MM:SS格式的this_date日期的小时，分钟和秒
NEXT_DATE          DATE            下一次定时运行任务的时间
NEXT_SEC           VARCHAR2(8)     如HH24:MM:SS格式的next_date日期的小时，分钟和秒
TOTAL_TIME         NUMBER          该任务运行所需要的总时间，单位为秒
BROKEN             VARCHAR2(1)     标志参数，Y标示任务中断，以后不会运行
INTERVAL           VARCHAR2(200)   用于计算下一运行时间的表达式
FAILURES           NUMBER     任务运行连续没有成功的次数
WHAT               VARCHAR2(2000)  执行任务的PL/SQL块
CURRENT_SESSION_LABEL RAW          MLSLABEL 该任务的信任Oracle会话符
CLEARANCE_HI          RAW MLSLABEL     该任务可信任的Oracle最大间隙
CLEARANCE_LO          RAW              MLSLABEL 该任务可信任的Oracle最小间隙
NLS_ENV               VARCHAR2(2000)   任务运行的NLS会话设置
MISC_ENV              RAW(32)          任务运行的其他一些会话参数
*/
-- 正在运行job
select * from dba_jobs_running;

其中最重要的字段就是job 这个值就是我们操作job的id号，what 操作存储过程的名称，next_date 执行的时间，interval执行间隔

 

二、执行间隔interval 运行频率

描述                              INTERVAL参数值
每天午夜12点                 TRUNC(SYSDATE + 1)
每天早上8点30分             TRUNC(SYSDATE + 1) + （8*60+30）/(24*60)
每星期二中午12点            NEXT_DAY(TRUNC(SYSDATE ), ‘‘TUESDAY‘‘ ) + 12/24
每个月第一天的午夜12点        TRUNC(LAST_DAY(SYSDATE ) + 1)
每个季度最后一天的晚上11点     TRUNC(ADD_MONTHS(SYSDATE + 2/24, 3 ), ‘Q‘ ) -1/24
每星期六和日早上6点10分        TRUNC(LEAST(NEXT_DAY(SYSDATE, ‘‘SATURDAY"), NEXT_DAY(SYSDATE, "SUNDAY"))) + （6×60+10）/（24×60）

每秒钟执行次

Interval => sysdate + 1/(24 * 60 * 60)

如果改成sysdate + 10/(24 * 60 * 60)就是10秒钟执行次

每分钟执行
Interval => TRUNC(sysdate,‘mi‘) + 1/ (24*60)

如果改成TRUNC(sysdate,‘mi‘) + 10/ (24*60) 就是每10分钟执行次

每天定时执行
例如：每天的凌晨1点执行
Interval => TRUNC(sysdate) + 1 +1/ (24)

每周定时执行
例如：每周一凌晨1点执行
Interval => TRUNC(next_day(sysdate,‘星期一‘))+1/24

每月定时执行
例如：每月1日凌晨1点执行
Interval =>TRUNC(LAST_DAY(SYSDATE))+1+1/24

每季度定时执行
例如每季度的第一天凌晨1点执行
Interval => TRUNC(ADD_MONTHS(SYSDATE,3),‘Q‘) + 1/24

每半年定时执行
例如：每年7月1日和1月1日凌晨1点
Interval => ADD_MONTHS(trunc(sysdate,‘yyyy‘),6)+1/24

每年定时执行
例如：每年1月1日凌晨1点执行
Interval =>ADD_MONTHS(trunc(sysdate,‘yyyy‘),12)+1/24

 

三、创建job方法

创建job,
基本语法：

 

declare
    variable job number;
begin
    sys.dbms_job.submit(job => :job,
    what => ‘prc_name;‘,
    next_date => to_date(‘22-11-2013 09:09:41‘, ‘dd-mm-yyyy hh24:mi:ss‘),
    interval => ‘sysdate+1/86400‘);--每天86400秒钟，即一秒钟运行prc_name过程一次
    commit;
end;

使用dbms_job.submit方法过程，这个过程有五个参数：job、what、next_date、interval与no_parse。

dbms_job.submit(
job       OUT binary_ineger,
What      IN  varchar2,
next_date IN  date,
interval  IN  varchar2,
no_parse  IN  booean:=FALSE)

job参数是输出参数，由submit()过程返回的binary_ineger，这个值用来唯一标识一个工作。一般定义一个变量接收，可以去user_jobs视图查询job值。
what参数是将被执行的PL/SQL代码块，存储过程名称等。
next_date参数指识何时将运行这个工作。
interval参数何时这个工作将被重执行。
no_parse参数指示此工作在提交时或执行时是否应进行语法分析——true，默认值false。指示此PL/SQL代码在它第一次执行时应进行语法分析，而FALSE指示本PL/SQL代码应立即进行语法分析。

 

四、其他job相关的存储过程

在dbms_job这个package中还有其他的过程：broken、change、interval、isubmit、next_date、remove、run、submit、user_export、what；

大致介绍下这些过程：

1、broken()过程更新一个已提交的工作的状态，典型地是用来把一个已破工作标记为未破工作。这个过程有三个参数：job 、broken与next_date。
procedure broken (
  job IN binary_integer,
  broken IN boolean,
  next_date IN date := SYSDATE
)
job参数是工作号，它在问题中唯一标识工作。
broken参数指示此工作是否将标记为破——true说明此工作将标记为破，而false说明此工作将标记为未破。
next_date参数指示在什么时候此工作将再次运行。此参数缺省值为当前日期和时间。

job如果由于某种原因未能成功执行，oracle将重试16次后，还未能成功执行，将被标记为broken，重新启动状态为broken的job，有如下两种方式;
a、利用dbms_job.run()立即执行该job
begin
  dbms_job.run(:job) --该job为submit过程提交时返回的job number或是去dba_jobs去查找对应job的编号
end;

b、利用dbms_job.broken()重新将broken标记为false
begin
  dbms_job.broken (:job, false, next_date)
end;

2、change()过程用来改变指定job的设置。
这个过程有四个参数：job、what 、next_date、interval。
procedure change (
    job IN binary_integer,
    what IN varchar2,
    next_date IN date,
    interval IN varchar2
)
此job参数是一个整数值，它唯一标识此工作。
what参数是由此job运行的一块PL/SQL代码块。
next_date参数指示何时此job将被执行。
interval参数指示一个job重执行的频度。

3、interval()过程用来显式地设置重复执行一个job之间的时间间隔数。
这个过程有两个参数：job、interval。
procedure interval(
    job IN binary_integer,
    interval IN varchar2
)
job参数标识一个特定的工作。
interval参数指示一个工作重执行的频度。

4、isubmit()过程用来用特定的job号提交一个job。
这个过程有五个参数：job、what、next_date、interval、no_parse。
procedure isubmit (
    job IN binary_ineger,
    what IN varchar2,
    next_date IN date,
    interval IN varchar2,
    no_parse IN booean := FALSE
)
这个过程与submit()过程的唯一区别在于此job参数作为IN型参数传递且包括一个由开发者提供的job号。如果提供的job号已被使用，将产生一个错误。

5、next_date()过程用来显式地设定一个job的执行时间。这个过程接收两个参数：job、next_date。
procedure next_date(
    job IN binary_ineger,
    next_date IN date
)
job标识一个已存在的工作。
next_date参数指示了此job应被执行的日期、时间。

6、remove()过程来删除一个已计划运行的job。这个过程接收一个参数：
procedure remove(job IN binary_ineger);
job参数唯一地标识一个工作这个参数的值是由为此工作调用submit()过程返回的job参数的值，已正在运行的job不能删除。

7、run()过程用来立即执行一个指定的job。这个过程只接收一个参数：
procedure run(job IN binary_ineger)
job参数标识将被立即执行的工作。

8、使用submit()过程，job被正常地计划。上面以讲述

9、user_export()过程返回一个命令，此命令用来安排一个存在的job以便此job能重新提交。此程序有两个参数：job、my_call。
procedure user_export(
    job IN binary_ineger,
    my_call IN OUT varchar2
)
job参数标识一个安排了的工作。
my_call参数包含在它的当前状态重新提交此job所需要的正文。

10、what()过程应许在job执行时重新设置此正在运行的命令。这个过程接收两个参数：job、what。
procedure what (
    job IN binary_ineger,
    what IN OUT varchar2
)
job参数标识一个存在的工作。
what参数指示将被执行的新的PL/SQL代码。实现的功能：每隔一分钟自动向getSysDate表中插入当前的系统时间。

 

五、示例

 

/* 每10秒钟执行一次 插入一条时间 */

-- 创建table
create table tab_time(
       current_time timestamp
);

-- 创建存储过程
create or replace procedure pro_job_print
as
   begin
       --dbms_output.put_line(‘系统时间：‘ || to_char(sysdate, ‘dd-mm-yyyy hh24:mi:ss‘));
       insert into tab_time values(sysdate);
   end;

-- 调用过程测试
begin
   pro_job_print;
end;


--select 24 * 60 * 60 from dual;

-- 创建job
declare
   job1 number;
begin
   dbms_job.submit(job1, ‘pro_job_print;‘, sysdate, ‘sysdate+10/86400‘);--每10插入一条记录
end;

--相关视图
select * from dba_jobs;
select * from all_jobs;
select * from user_jobs;
-- 正在运行job
select * from dba_jobs_running;


-- 运行job
begin
   dbms_job.run(26);--和select * from user_jobs; 中的job值对应，看what对应的过程
end;

-- 查询是否插入数据
select to_char(current_time, ‘dd-mm-yyyy hh24:mi:ss‘) current_time from tab_time order by current_time;

-- 删除一个job
begin
   dbms_job.remove(26);--和select * from user_jobs; 中的job值对应，看what对应的过程
end;

 

六、关于设置job任务数量和控制并发

初始化相关参数job_queue_processes
alter system set job_queue_processes = 39 scope = spfile;//最大值不能超过1000;
job_queue_interval = 10; //调度作业刷新频率秒为单位

job_queue_process 表示oracle能够并发的job的数量，sqlplus中可以通过语句
show parameter job_queue_process; 来查看oracle中job_queue_process的值。

select * from v$parameter;

select name, description from v$bgprocess;

当job_queue_process值为0时表示全部停止oracle的job，可以通过语句
alter system set job_queue_processes = 10;
来调整启动oracle的job。

如果将job_queue_processes 的值设置为1的话，那就是串行运行，即快速切换执行一个job任务。

 

七、job不运行的大概原因

(1)、上面讲解了job的参数：与job相关的参数一个是job_queue_processes，这个是运行job时候所起的进程数，当然系统里面job大于这个数值后，就会有排队等候的，最小值是0，表示不运行job，最大值是1000，在OS上对应的进程时SNPn，9i以后OS上管理job的进程叫CJQn。可以使用下面这个SQL确定目前有几个SNP/CJQ在运行。
select * from v$bgprocess，这个paddr不为空的snp/cjq进程就是目前空闲的进程，有的表示正在工作的进程。
另外一个是job_queue_interval，范围在1--3600之间，单位是秒，这个是唤醒JOB的process，因为每次snp运行完他就休息了，需要定期唤醒他，这个值不能太小，太小会影响数据库的性能。

先确定上面这两个参数设置是否正确，特别是第一个参数，设置为0了，所有job就不会自动运行了。

(2)、使用下面的SQL查看job的的broken，last_date和next_date，last_date是指最近一次job运行成功的结束时间，next_date是根据设置的频率计算的下次执行时间，根据这个信息就可以判断job上次是否正常，还可以判断下次的时间对不对，SQL如下：
select * from dba_jobs;
有时候我们发现他的next_date是4000年1月1日，说明job要不就是在running，要不就是状态是break(broken=Y)，如果发现job的broken值为Y，找用户了解一下，确定该job是否可以broken，如果不能broken，那就把broken值修改成N，修改再使用上面的SQL查看就发现它的last_date已经变了，job即可正常运行，修改broken状态的SQL如下：

begin
    DBMS_JOB.BROKEN(<JOB_ID>, FALSE);
end;

(3)、使用下面的SQL查询是否job还在running
select * from dba_jobs_running;
如果发现job已经Run了很久了还没有结束，就要查原因了。一般的job running时会锁定相关的相关的资源，可以查看一下v$access和v$locked_object这两个view。如果发现其他进程锁定了与job相关的object，包括package/function/procedure/table等资源，那么就要把其他进程删除，有必要的话，把job的进程也删除，再重新执行看看结果。

(4)、如果上面都正常，但是job还不run，怎么办？那我们要考虑把job进程重启一次，防止是SNP进程死了造成job不跑，指令如下：
alter system set job_queue_processes = 0; --关闭job进程，等待5--10秒钟
alter system set job_quene_processes = 5; --恢复原来的值

(5)、Oracle的BUG：Oracle9i里面有一个BUG，当计数器到497天时，刚好达到它的最大值，再计数就会变成-1，继续计数就变成0了，然后计数器将不再跑了。如果碰到这种情况就得重启数据库，但是其他的Oracle7345和Oracle8i的数据库没有发现这个问题。

(6)、数据库上的检查基本上就这多，如果job运行还有问题，那需要看一下是否是程序本身的问题，比如处理的资料量大，或者网络速度慢等造成运行时过长，那就需要具体情况具体分析了。我们可以通过下面的SQL手工执行一下job看看：

begin
      dbms_job.run(<job>_ID)
end;
如果发现job执行不正常，就要结合程序具体分析一下。