二,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說明此工作將標記為破,而FLASE說明此工作將標記為未破。 next_date引數指示在什麼時候此工作將再次執行。此引數預設值為當前日期和時間。 job如果由於某種原因未能成功之行,oracle將重試16次後,還未能成功執行,將被標記為broken 重新啟動狀態為broken的job,有如下兩種方式; a、利用dbms_job.run()立即執行該job sql>begin sql>dbms_job.run(:jobno) 該jobno為submit過程提交時返回的job number sql>end; sql>/ b、利用dbms_job.broken()重新將broken標記為false sql>begin sql>dbms_job.broken (:job,false,next_date) sql>end; sql>/ 2、 Change()過程用來改變指定工作的設定。 這個過程有四個引數:job、what 、next_date與interval。
PROCEDURE Change (job IN binary_integer, What IN varchar2, next_date IN date, interval IN varchar2)
此job引數是一個整數值,它唯一標識此工作。 What引數是由此工作執行的一塊PL/SQL程式碼塊。 next_date引數指示何時此工作將被執行。 interval引數指示一個工作重執行的頻度。
3、 Interval()過程用來顯式地設定重執行一個工作之間的時間間隔數。 這個過程有兩個引數:job與interval。
PROCEDURE Interval (job IN binary_integer, Interval IN varchar2)
job引數標識一個特定的工作。interval引數指示一個工作重執行的頻度。
4、 ISubmit()過程用來用特定的工作號提交一個工作。 這個過程有五個引數: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型引數傳遞且包括一個 由開發者提供的工作號。如果提供的工作號已被使用,將產生一個錯誤。
5、 Next_Date()過程用來顯式地設定一個工作的執行時間。這個過程接收兩個引數:job與next_date。
PROCEDURE Next_Date(job IN binary_ineger, next_date IN date)
job標識一個已存在的工作。next_date引數指示了此工作應被執行的日期與時間。
6、 Remove()過程來刪除一個已計劃執行的工作。這個過程接收一個引數:
PROCEDURE Remove(job IN binary_ineger);
job引數唯一地標識一個工作。這個引數的值是由為此工作呼叫Submit()過程返回的job引數的值。 已正在執行的工作不能由呼叫過程式刪除。
7、 Run()過程用來立即執行一個指定的工作。這個過程只接收一個引數:
PROCEDURE Run(job IN binary_ineger)
job引數標識將被立即執行的工作。
8、 使用Submit()過程,工作被正常地計劃好。 這個過程有五個引數:job、what、next_date、interval與no_parse。
PROCEDURE Submit ( job OUT binary_ineger, What IN varchar2, next_date IN date, interval IN varchar2, no_parse IN booean:=FALSE)
job引數是由Submit()過程返回的binary_ineger。這個值用來唯一標識一個工作。 what引數是將被執行的PL/SQL程式碼塊。 next_date引數指識何時將執行這個工作。 interval引數何時這個工作將被重執行。 no_parse引數指示此工作在提交時或執行時是否應進行語法分析——TRUE 指示此PL/SQL程式碼在它第一次執行時應進行語法分析, 而FALSE指示本PL/SQL程式碼應立即進行語法分析。
9、 User_Export()過程返回一個命令,此命令用來安排一個存在的工作以便此工作能重新提交。 此程式有兩個引數:job與my_call。
PROCEDURE User_Export(job IN binary_ineger, my_call IN OUT varchar2)
job引數標識一個安排了的工作。my_call引數包含在它的當前狀態重新提交此工作所需要 的正文。
10、 What()過程應許在工作執行時重新設定此正在執行的命令。這個過程接收兩個引數:job與what。
PROCEDURE What (job IN binary_ineger, What IN OUT varchar2)
job引數標識一個存在的工作。what引數指示將被執行的新的PL/SQL程式碼。
三、檢視相關job資訊 1、相關檢視 dba_jobs all_jobs user_jobs dba_jobs_running 包含正在執行job相關資訊
2、檢視相關資訊
SQL>SELECT JOB, NEXT_DATE, NEXT_SEC, FAILURES, BROKEN SQL>FROM DBA_JOBS;
JOB NEXT_DATE NEXT_SEC FAILURES B ------- --------- -------- -------- - 9125 01-JUN-01 00:00:00 4 N 14144 24-OCT-01 16:35:35 0 N 9127 01-JUN-01 00:00:00 16 Y 3 rows selected.
正在執行的JOB相關資訊
SELECT SID, r.JOB, LOG_USER, r.THIS_DATE, r.THIS_SEC FROM DBA_JOBS_RUNNING r, DBA_JOBS j WHERE r.JOB = j.JOB;
SID JOB LOG_USER THIS_DATE THIS_SEC ----- ---------- ------------- --------- -------- 12 14144 HR 24-OCT-94 17:21:24 25 8536 QS 24-OCT-94 16:45:12 2 rows selected. JOB QUEUE LOCK相關資訊
SELECT SID, TYPE, ID1, ID2 FROM V$LOCK WHERE TYPE = 'JQ';
SID TY ID1 ID2 --------- -- --------- --------- 12 JQ 0 14144 1 row selected.
四、簡單例子
一個簡單例子:
建立測試表 SQL> create table TEST(a date);
表已建立。
建立一個自定義過程 SQL> create or replace procedure MYPROC as 2 begin 3 insert into TEST values(SYSDATE); 4 end; 5 /
過程已建立。
建立JOB SQL> variable job1 number; SQL> SQL> begin 2 dbms_job.submit(:job1,'MYPROC;',SYSDATE,'SYSDATE+1/1440'); --每天1440分鐘,即一分鐘執行test過程一次 3 end; 4 /
PL/SQL 過程已成功完成。
執行JOB SQL> begin 2 dbms_job.run(:job1); 3 end; 4 /
PL/SQL 過程已成功完成。
SQL> select to_char(a,'yyyy/mm/dd hh24:mi:ss') 時間 from TEST;
時間 ------------------- 2001/01/07 23:51:21 2001/01/07 23:52:22 2001/01/07 23:53:24
刪除JOB SQL> begin 2 dbms_job.remove(:job1); 3 end; 4 /
PL/SQL 過程已成功完成。 五、相關注意事項
1、執行dbms_job包相關過程如remove、Change、broken時,登陸的使用者要同建立該JOB的使用者一致
2、當執行dbms_job.change過程時,如果引數what,next_date,interval值為null,則表示原引數值不變 如 BEGIN DBMS_JOB.CHANGE(14144, NULL, NULL, 'SYSDATE + 3'); END; /
3、如果利用database link來提交job,則該link必須包含合適的使用者名稱和密碼。
4、執行job的使用者必須具有作業過程中所涉及物件的相應許可權。
5、資料庫在restricted mode下,不能執行job 6、job_queue_processes這個值可不能是0,要根據具體job的情況設定合適的值
|