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執行不正常，就要結合程式具體分析一下。

Oracle job procedure 預存程序定時任務