ORACLE的存储过程的异步调用

http://tech.ccidnet.com/art/294/20030526/47427_1.html

ORACLE的存储过程的异步调用
作者：王辉 发文时间：2003.05.26

　　1. 关于作者

　　王辉　从1994年开始工作，曾担任教师、数据库管理员、主程序员、项目经理，现在深圳一家公司担任项目经理。可以通过[e-mail]联系。

　　2. 前言

　　在ＯＲＡＣＬＥ数据库实际应用过程中，经常把业务处理逻辑的放在存储过程，客户端通过ＡＤＯ进行调用。有些业务逻辑处理量大并且复杂，使客户端调用存储过程后，长时间没有反应，也不知存储过程运行状态，本文讲述如何在ＯＲＡＣＬＥ通过任务和管道的应用，异步调用存储过程的方法。

　　3. 基本原理

　　　　1.使用DBMS_JOB包将主处理存储过程作为任务提交到任务队列中

　　　　2.主处理存储过程在运行过程中通过DBMS_PIPE包将处理情况放在管道中

　　　　3.监控存储过程读取管道，从而了解处理情况

　　　　4.本文没有描述双向通信的方式，监控存储过程可以通过管道发送信息给主处理存储过程

　　4. 具体实现测试

　　建立测试环境

　　4.1. 对数据库的ini进行相关修改，使系统的任务队列功能打开

　　对于ORACLE9I，只需修设定数据库的INI内的"JOB_QUEUE_PROCESSES=非0值"，如 "JOB_QUEUE_PROCESSES=10"，对于ORACLE8I除设定实例ini文件中的"JOB_QUEUE_PROCESSES=非0值"外，还需设定"job_queue_interval=1"

　　4.2. 设用用户权限

　　由于使用ORACLE中特定的程序包，所以要注意要明文给于用户系统权限。对当前用户（测试用户），赋于以下权力

EXECUTE DBMS_PIPE
EXECUTE DBMS_LOCK
EXECUTE DBMS_JOB



　　4.3. 建立模拟大业务处理存储过程

　　本存储过程通过循环30次，调用DBMS_LOCK.SLEEP(1)（体眠1秒）和写管道模拟大的处理过程。

　　具体代码如下：

CREATE OR REPLACE PROCEDURE maxpro AS
n integer;
status NUMBER;
BEGIN
FOR N IN 1..30 LOOP
DBMS_PIPE.PURGE('maxpro'); --清除原管道信息
DBMS_PIPE.PACK_MESSAGE(N); --把信息放入缓冲区
status:=DBMS_PIPE.SEND_MESSAGE('maxpro');
DBMS_LOCK.SLEEP(1);
END LOOP;
DBMS_PIPE.PURGE('maxpro'); --清除原管道信息
DBMS_PIPE.PACK_MESSAGE(999999); --把信息放入缓冲区,用999999 表示过程完成
status:=DBMS_PIPE.SEND_MESSAGE('maxpro');
END maxpro;



　　4.4. 建立读取管道动态了解处理状态的存储过程

　　以下代码是对于maxpro存储过程的状态进行读取的过程，主要使用读取管道的方法，注意：

status:= DBMS_PIPE.RECEIVE_MESSAGE('maxpro',0);



　　中的"0"参数是很关键的，说明接受等待时间为0秒，表示,调用时如果没有信息不等待直接返回。

　　具体代码如下：

CREATE OR REPLACE PROCEDURE readmaxpro AS
n integer;
status integer;
begin
--接受等待时间为1秒,可以为0,立即调用或DBMS_PIPE.RECEIVE_MESSAGE('mypipe') 等待100天
status:= DBMS_PIPE.RECEIVE_MESSAGE('maxpro',0);
--status为0为成功可以UNPACK_MESSAGE，1为超时没有数据，2为信息太大，3为内部错误
IF status <> 0 THEN
DBMS_OUTPUT.PUT_LINE('管道中现在没有信息返回');
return;
END IF;
DBMS_PIPE.UNPACK_MESSAGE(n);
DBMS_OUTPUT.PUT_LINE('maxpro 的当前进行状态为'|| n);
end;



　　4.5. -起动模拟大业务处理存储过程为后台进程的存储过程（BEGINMAXPRO）

　　通过DBMS_JOB.SUBMIT(JOB,'maxpro;',sysdate,NULL,FALSE);使"maxpro"为一个任务，在当前时间（sysdate）后执行,当然如果把sysdate改一具体时间，那就在具体时间执行

　　具休代码如下：

CREATE OR REPLACE PROCEDURE beginmaxpro AS
JOB BINARY_INTEGER;
BEGIN
DBMS_JOB.SUBMIT(JOB,'maxpro;',sysdate,NULL,FALSE);
DBMS_OUTPUT.PUT_LINE('队列号码JOB=' || JOB);
COMMIT;
end;



　　5. 代码执行

　　5.1. 执行过程

　　注：黑体字是屏幕输出，下划线字是输入内容
　　在CMD行输入 sqlplus 根据提示登录
　　设定DBMS_OUTPUT可见
　　SQL> set serveroutput ON
　　以下是执行过程和相应的返回信息
　　SQL> call beginmaxpro();
　　队列号码JOB=21
　　调用完成。
　　SQL> call readmaxpro();
　　maxpro 的当前进行状态为14
　　调用完成。
　　SQL> call readmaxpro();
　　maxpro 的当前进行状态为16
　　调用完成。
　　SQL> call readmaxpro();
　　maxpro 的当前进行状态为23
　　调用完成。
　　SQL> call readmaxpro();
　　maxpro 的当前进行状态为999999
　　调用完成。
　　SQL> call readmaxpro();
　　管道中现在没有信息返回
　　调用完成。
　　SQL>



　　5.2. 执行分析

　　beginmaxpro()，将主处理存储过程放入队列的过程，执行后存储程序马上返回，maxpro存储过程放在任务队列中，并设定为在当前系统时间执行（马上执行）

　　maxpro为主处理存储过程，开始执行模拟大业务处理，处理过程中将处理进度信息写入管道

　　readmaxpro();为检查状态存储过程，首先读取信息，如果信息不存在，说明管道内没有信息可读而退出；如果存在信息则读出信息

　　本例子可以进行改进，输出不通过DBMS_OUTPUT.PUT_LINE而是用返回值，那么就可以在前端用ADO调用，发布任务，任务过程中从客户端读取进度。代码如下：

CREATE OR REPLACE PROCEDURE readmaxpro(p out intergr) AS
n integer;
status integer;
begin
status:= DBMS_PIPE.RECEIVE_MESSAGE('maxpro',0);
IF status <> 0 THEN
P:=-1;
return;
END IF;
DBMS_PIPE.UNPACK_MESSAGE(p);
end;



　　6. 附录：

　　6.1. 相关程序包说明

1
DBMS_JOB.SUBMIT(
JOB OUT BINARY_INTEGER,
WHAT IN VARCHAR2,
NEXT_DATE IN DATE DEFAULTSYSDATE,
INTERVAL IN VARCHAR2 DEFAULT 'NULL',
NO_PARSE IN BOOLEAN DEFAULT FALSE,
INSTANCE IN BINARY_INTEGER DEFAULT ANY_INSTANCE,
FORCE IN BOOLEAN DEFAULT FALSE)
功能：提交作业入作业队列
参数说明：
JOB:作业的作业号，输出参数
WHAT：作业对应的PL/SQL代码（一般用于过程名)
NEXT_DATE:下一次作业运行的时间
INTERVAL:作业执行间隔时间，缺省是NULL,只执行一次
NO_PARSE:是否对WHAT语句，在提交时进行分析，缺省是进行分析。
INSTANCE：作业提交时，指明运行作业的实例，缺省是0，任何的数据库全可以
FORCE：是否检查INSTANCE指定的数据库在运行，缺省是FALSE，不检查
例子：
declare
jobn number;
begin
DBMS_JOB.SUBMIT(jobn,'maxpro;',sysdate);
DBMS_OUTPUT.PUT_LINE('JOB=' || jobn);
COMMIT;
end;



　　注意：

　　设定数据库参数JOB_QUEUE_PROCESSES = 非0值（最大队列数最大60）

　　对于9I前设定数据库参数JOB_QUEUE_INTERVAL = 非0值（队列扫描周期1-3600秒）

　　2

DBMS_PIPE.PACK_MESSAGE (item IN VARCHAR2);
DBMS_PIPE.PACK_MESSAGE (item IN NCHAR);
DBMS_PIPE.PACK_MESSAGE (item IN NUMBER);
DBMS_PIPE.PACK_MESSAGE (item IN DATE);
DBMS_PIPE.PACK_MESSAGE_RAW (item IN RAW);
DBMS_PIPE.PACK_MESSAGE_ROWID (item IN ROWID);
功能：把一个数据项放到私有数据缓冲区



3

DBMS_PIPE.SEND_MESSAGE (
pipename IN VARCHAR2,
timeout IN INTEGER DEFAULT MAXWAIT,
maxpipesize IN INTEGER DEFAULT 8192)
RETURN INTEGER;
功能：发送私有数据缓冲区的信息到命名管道，如果管道不存在就建立





4

DBMS_PIPE.RECEIVE_MESSAGE (
pipename IN VARCHAR2,
timeout IN INTEGER DEFAULT maxwait) RETURN INTEGER;
功能：从管道到接受信息放到数据缓冲区



5

DBMS_PIPE.UNPACK_MESSAGE (item OUT VARCHAR2);
DBMS_PIPE.UNPACK_MESSAGE (item OUT NCHAR);
DBMS_PIPE.UNPACK_MESSAGE (item OUT NUMBER);
DBMS_PIPE.UNPACK_MESSAGE (item OUT DATE);
DBMS_PIPE.UNPACK_MESSAGE_RAW (item OUT RAW);
DBMS_PIPE.UNPACK_MESSAGE_ROWID (item OUT ROWID);
功能：从数据缓冲区接收下一个数据项



6

DBMS_PIPE.PURGE ( pipename IN VARCHAR2);
功能：清除管道内的信息