Oracle 管道化表函数(Pipelined Table)

在实际的应用中，为了让PL/SQL 函数返回数据的多个行，必须通过返回一个 REF CURSOR 或一个数据集合来完成。REF CURSOR 的这种情况局限于可以从查询中选择的数据，而整个集合在可以返回前，必须进行具体化。 9i 通过引入的管道化表函数纠正了后一种情况。表函数是返回整个行的集（通常作为一个集合）的函数，可以直接从 SQL 语句中进行查询，就好像它是一个真正的数据库表一样。管道化表函数与之相似，但是它像在构建时一样返回数据，而不是一次全部返回。管道化表函数更加有效， 因为数据可以尽可能快地返回。

    管道化表函数必须返回一个集合。在函数中，PIPE ROW 语句被用来返回该集合的单个元素，该函数必须以一个空的 RETURN 语句结束，以表明它已经完成。一旦我们创建了上述函数，我们就可以使用 TABLE 操作符从 SQL 查询中调用它。

例1：
Type Definition

1 CREATE OR REPLACE TYPE COLOR_HEX_CODE AS OBJECT
2 (
3 -- Attributes
4   colorName Varchar2 ( 10 ),
5 colorCode varchar2 ( 10 )
6
7 -- Member functions and procedures
8   -- member procedure <ProcedureName>(<Parameter> <Datatype>)
9   );

 

Create Table Type

CREATE OR REPLACE TYPE COLOR_TYPE AS TABLE OF COLOR_HEX_CODE;

 

Create Table Function

1 CREATE OR REPLACE FUNCTION F_PIPELINE_TEST RETURN COLOR_TYPE PIPELINED
2   AS
3   BEGIN
4 PIPE ROW(COLOR_HEX_CODE( ' black ' , ' #000000 ' ));
5 PIPE ROW(COLOR_HEX_CODE( ' white ' , ' #FFFFFF ' ));
6 PIPE ROW(COLOR_HEX_CODE( ' red ' , ' #FF0000 ' ));
7 PIPE ROW(COLOR_HEX_CODE( ' green ' , ' #00FF00 ' ));
8 PIPE ROW(COLOR_HEX_CODE( ' blue ' , ' #0000FF ' ));
9 RETURN ;
10   END ;

 

测试:

select * from table ( f_pipeline_test );

 

 

 

结果：
COLORNAME  COLORCODE
black   #000000
white   #FFFFFF
red   #FF0000
green   #00FF00
blue   #0000FF

例2：实现split函数功能

CREATE OR REPLACE TYPE RESOLVE_STR IS TABLE OF VARCHAR2 ( 4000 );

 

1 CREATE OR REPLACE FUNCTION F_SPLIT
2 (
3 P_STR IN VARCHAR2 ,
4 P_DELIMITER IN varchar2
5 ) RETURN RESOLVE_STR PIPELINED
6   AS
7 j INT : = 0 ;
8 i INT : = 1 ;
9 len INT : = 0 ;
10 len1 INT : = 0 ;
11 tmp VARCHAR2 ( 4000 );
12 v_str VARCHAR2 ( 4000 );
13   BEGIN
14 v_str : = TRIM(BOTH P_DELIMITER FROM P_STR); -- 去掉前后的分隔符
15   len : = LENGTH (v_str);
16 len1 : = LENGTH(P_DELIMITER);
17
18 WHILE j < len
19 LOOP
20 j : = INSTR (v_str, P_DELIMITER, i); -- 寻分隔符位置
21  
22 IF j = 0 THEN -- 没有了
23   tmp : = SUBSTR (v_str, i);
24 PIPE ROW (tmp);
25 EXIT ; -- 结束
26   ELSE
27 tmp : = SUBSTR (v_str, i, j - i);
28 i : = j + len1;
29 PIPE ROW (tmp);
30 END IF ;
31 END LOOP;
32
33 RETURN ;
34 END ;

 

 

 

测试：

SELECT * FROM TABLE (F_SPLIT( ' -12-02-ab-cd-a0-ef- ' , ' - ' ));

例3：产生6个0..49的随机数
First the quick-and-dirty solution without a pipelined function

1 select r from (
2 select r from (
3 select rownum r from all_objects where rownum < 50
4 ) order by dbms_random.VALUE
5 ) where rownum <= 6 ;

 

pipelined function

CREATE OR REPLACE TYPE ARRAY AS TABLE OF NUMBER ;

 

1 CREATE OR REPLACE FUNCTION gen_numbers(n IN NUMBER DEFAULT NULL )
2 RETURN ARRAY PIPELINED
3 AS
4 BEGIN
5 FOR i IN 1 .. nvl(n, 9999 )
6 LOOP
7 PIPE ROW(i);
8 END LOOP;
9 RETURN ;
10 END ;

 

测试：

1 select * from (
2 select *
3 from ( select * from table (gen_numbers( 49 ))) order by dbms_random.random
4 )
5 where rownum <= 6

generating that range of dates

select to_date( ' 2009-5-10 ' , ' yyyy-mm-dd ' ) + column_value - 1 from TABLE (gen_numbers( 15 ));

Note the name of the column we used: COLUMN_VALUE. That is the default name for the column coming back from the PIPELINED function.
another example

CREATE OR REPLACE TYPE date_array AS TABLE OF DATE;

 

1 CREATE OR REPLACE FUNCTION date_table(sdate DATE, edate DATE)
2 RETURN date_array PIPELINED AS
3 BEGIN
4 FOR i IN 0 .. (edate - sdate)
5 LOOP
6 PIPE ROW(sdate + i);
7 END LOOP;
8 RETURN ;
9 END date_table;