oracle管道(pipelined function)函数用法

oracle管道(pipelined function)函数用法_转 


Oraclepipelined function)pipe row管理函数 
      oracle数据库中的管道函数以一个空的RETURN 语句结束，以表明它已经完成。下文对oracle管道函数的用法作了详细的说明，供您参考。
      oracle管道函数是一类特殊的函数，oracle管道函数返回值类型必须为集合，下面就为您将介绍oracle管道函数的语法，供您参考学习。
      在普通的函数中，使用dbms_output输出的信息，需要在服务器执行完整个函数后一次性的返回给客户端。如果需要在客户端实时的输出函数执行过程中的一些信息，在oracle9i以后可以使用管道函数(pipeline function)。
      关键字PIPELINED表明这是一个oracle管道函数，oracle管道函数的返回值类型必须为集合，在函数中，PIPE ROW语句被用来返回该集合的单个元素，函数以一个空的RETURN 语句结束，以表明它已经完成。
 
     下文是自己补充,以帮助理解.
     在创建管道函数之前必须创建一个用于存放管道函数返回值的类型.因为管道的返回值可以看做是一个虚表.
1.创建type对象.
Sql代码     
1. create or replace type <SPAN><SPAN>MsgType</SPAN>   
2. </SPAN>   
3. as table of varchar2(4000);   
2.创建管道函数,注意PIPELINED关键字.和pipe的用法.
Sql代码     
1. create or replace function f_pipeline_test     
2. return MsgType     
3. PIPELINED     
4. as     
5. begin     
6.   for i in 1 .. 10     
7.   loop     
8.      pipe row( 'Iteration ' || i || ' at ' || systimestamp );     
9.      dbms_lock.sleep(1);     
10.   end loop;     
11.      pipe row( 'All done!' );     
12.   return;     
13. end;    
      在sql*plus中执行该函数，首先设置arraysize为1，否则服务器会按照默认的15来向客户端返回信息，这会影响我们的测试效果。
Sql代码     
1. SQL> set arraysize 1     
2. SQL> select * from table( f_pipeline_test );     
3.    
4. COLUMN_VALUE     
5. --------------------------------------------------------------------------------     
6. Iteration 1 at 14-FEB-08 02.13.18.273988000 PM +08:00     
7. Iteration 2 at 14-FEB-08 02.13.19.275988000 PM +08:00     
8. Iteration 3 at 14-FEB-08 02.13.20.277767000 PM +08:00     
9. Iteration 4 at 14-FEB-08 02.13.21.279591000 PM +08:00     
10. Iteration 5 at 14-FEB-08 02.13.22.281366000 PM +08:00     
11. Iteration 6 at 14-FEB-08 02.13.23.283189000 PM +08:00     
12. Iteration 7 at 14-FEB-08 02.13.24.283965000 PM +08:00     
13. Iteration 8 at 14-FEB-08 02.13.25.285785000 PM +08:00     
14. Iteration 9 at 14-FEB-08 02.13.26.286570000 PM +08:00     
15. Iteration 10 at 14-FEB-08 02.13.27.288387000 PM +08:00     
16. All done!     
17.    
18. 11 rows selected