oracle管道(pipelined_function)函数用法

Oraclepipelined function)piperow管理函数 

      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);   

create or replace type MsgType

 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;    

create or replace functionf_pipeline_test 

return MsgType 

PIPELINED 

as 

begin 

   for i in 1 .. 10 

   loop 

      pipe row( 'Iteration ' || i || ' at ' ||systimestamp ); 

      dbms_lock.sleep(1); 

   end loop; 

      pipe row( 'All done!' ); 

   return; 

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