bJOB
用法小结
网上收集并结合实践
一、设置初始化参数 job_queue_processes
sql> alter system set job_queue_processes=n; ( n>0 )
job_queue_processes 最大值为 1000
查看该值
show parameter processes
查看 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 代码应立即进行语法分析。
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 过程已成功完成。
查看 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 代码应立即进行语法分析。
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 过程已成功完成。
上面的例子没有涉及到存储过程带参数的问题,如果带参数假设为
MYPROC( ina IN VARCHAR2,
------------------以下为必须输出参数组---------------------------------
outa OUT NUMBER,
outb OUT VARCHAR2)
则 在建立job的代码中
创建JOB
begin
sys.dbms_job.submit(job => :job,
what => '
declare
outa number; --定义输出变量
outb varchar2(40);
begin
MYPROC(''输入'',outa =>outa ,outb =>outb );
end;',
next_date => to_date('10-10-2006 08:48:34', 'dd-mm-yyyy hh24:mi:ss'),
interval => 'sysdate+1');
commit;
end;
/
MYPROC( ina IN VARCHAR2,
------------------以下为必须输出参数组---------------------------------
outa OUT NUMBER,
outb OUT VARCHAR2)
则 在建立job的代码中
创建JOB
begin
sys.dbms_job.submit(job => :job,
what => '
declare
outa number; --定义输出变量
outb varchar2(40);
begin
MYPROC(''输入'',outa =>outa ,outb =>outb );
end;',
next_date => to_date('10-10-2006 08:48:34', 'dd-mm-yyyy hh24:mi:ss'),
interval => 'sysdate+1');
commit;
end;
/
五、相关注意事项
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