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错误。