首页 > 代码库 > oracle管道函数的用法

oracle管道函数的用法

oracle管道函数是一类特殊的函数,oracle管道函数返回值类型必须为集合,下面将介绍oracle管道函数的语法。

在普通的函数中,使用dbms_output输出的信息,需要在服务器执行完整个函数后一次性的返回给客户端。如果需要在客户端实时的输出函数执行过程中的一些信息,在oracle9i以后可以使用管道函数(pipeline function)。

关键字PIPELINED表明这是一个oracle管道函数,oracle管道函数的返回值类型必须为集合,在函数中,PIPE ROW语句被用来返回该集合的单个元素,函数以一个空的RETURN 语句结束,以表明它已经完成。

 1 create or replace type MsgType as table of varchar2(4000);
 2 /
 3 
 4 create or replace function f_pipeline_test return MsgType
 5   PIPELINED as
 6 begin
 7   for i in 1 .. 10 loop
 8     pipe row(Iteration  || i ||  at  || systimestamp);
 9     sys.dbms_lock.sleep(1);
10   end loop;
11   pipe row(All done!);
12   return;
13 end;
14 /

若以上function执行过程中提示错误:“Error: PLS-00201: 必须说明标识符 ‘DBMS_LOCK‘”,则是由于授权的原因,可通过如下方案解决:

conn system/bitservice@ttonline as sysdba;
grant execute on dbms_lock to tt;

为了在sql*plus演示管道函数的执行效果,我们需要将arraysize为1,否则服务器会按照默认的15来向客户端返回信息,这会影响我们的测试效果。

set arraysize 1
select * from table( f_pipeline_test );

如果要在pipeline中执行DML操作,则必须使用自治事务,否则会报ORA-14551错误。

在oracle9205及其之后的版本中,在pipeline function中使用自治事务,则必须在pipe row之前提交或者回滚事务,否则会报ORA-06519错误。