Oracle dbms_job package 用法小結

一、設置初始化參數 job_queue_processes
      job_queue_processes=4  
      job_queue_interval=10  
sql> alter system set job_queue_processes=n;(n>0)
job_queue_processes最大值爲1000  

查看job queue 後臺進程
sql>select name,description from v$bgprocess;

  

二、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代碼應立即進行語法分析。 

示例:

begin
  sys.dbms_job.submit(job => :job,
                      what => test_sql;',
                      next_date => trunc(sysdate)+23/24,
                      interval => 'trunc(next_day(sysdate,''星期五''))+23/24');
  commit;
end;

     其中:job是系統自動產生編號,test_sql是一個過程,next_date設置下次執行時間,這裏是今天晚上23:00,interval設置時間間隔,多久執行一次,這裏是每週的星期五晚上23:00,函數next_day返回日期中包含指定字符的日期,trunc 函數去掉日期裏的時間,也就是得到的是某天的00:00,時間是以天爲單位的所以要得到某某點某某分,就需要分數:

1/24      一小時;
1/1440    一分;
1/3600    一秒; 

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 FROM DBA_JOBS;  

正在運行的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; 
 
JOB QUEUE LOCK相關信息  
select SID, TYPE, ID1, ID2 FROM V$LOCK where TYPE = ’JQ’;

四、簡單例子
一個簡單例子:   
創建測試表
SQL> create table TEST(tm 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> print job1;

      JOB1
----------
        21

運行JOB
SQL> begin
2 dbms_job.run(:job1);
3 end;
4 /  
PL/SQL 過程已成功完成。 

驗證 

SQL> select to_char(tm,'yyyy/mm/dd hh24:mi:ss') 時間 from TEST;

時間
-------------------
2009/08/24 17:21:02
2009/08/24 17:24:07
2009/08/24 17:25:09
刪除JOB

SQL> begin
2 dbms_job.remove(:job1);
3 end;
4 /  
PL/SQL 過程已成功完成。

五. 實際應用示例:定時analyzed所有表,因爲必須對錶分析以後,num_rows 纔會有值

1.創建存儲過程:

CREATE OR REPLACE PROCEDURE USER."ANALYZEDB"
IS
   CURSOR get_ownertable
   IS
      SELECT table_name
        FROM user_tables;

   ownertable   get_ownertable%ROWTYPE;
BEGIN
   OPEN get_ownertable;

   LOOP
      FETCH get_ownertable
       INTO ownertable;

      EXIT WHEN get_ownertable%NOTFOUND;

      EXECUTE IMMEDIATE    'analyze table '
                        || ownertable.table_name
                        || ' compute statistics for table for all indexes for all indexed columns ';
   END LOOP;
EXCEPTION
   WHEN OTHERS
   THEN
      RAISE;
END;
/

2. 創建JOB.

BEGIN
  SYS.DBMS_JOB.REMOVE(3);
COMMIT;
END;
/

DECLARE
  X NUMBER;
BEGIN
  SYS.DBMS_JOB.SUBMIT
  ( job       => X
   ,what      => 'ANALYZEDB;'
   ,next_date => to_date('26-08-2009 06:00:00','dd/mm/yyyy hh24:mi:ss')
   ,interval  => 'trunc(sysdate + 7) + 6/24'
   ,no_parse  => FALSE
  );
  SYS.DBMS_OUTPUT.PUT_LINE('Job Number is: ' || to_char(x));
COMMIT;
END;
/

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章