oracle 管道化表函数(Pipelined Table) [转]

介绍Oracle管道化表函数的创建及使用方法,包括定义类型、创建表类型、创建表函数等步骤,并提供多个实例演示其功能。

关键字: oracle pipelined table

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

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

例1:
Type Definition
Sql代码
  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 OR REPLACE TYPE COLOR_HEX_CODE AS OBJECT (   -- Attributes   colorName Varchar2(10),   colorCode varchar2(10)      -- Member functions and procedures   --member procedure <ProcedureName>(<Parameter> <Datatype>) ); 

Create Table Type
Sql代码
  1. CREATE OR REPLACE TYPE COLOR_TYPE AS TABLE OF COLOR_HEX_CODE;  
CREATE OR REPLACE TYPE COLOR_TYPE AS TABLE OF COLOR_HEX_CODE; 

Create Table Function
Sql代码
  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;  
CREATE OR REPLACE FUNCTION F_PIPELINE_TEST RETURN COLOR_TYPE PIPELINED AS BEGIN     PIPE ROW(COLOR_HEX_CODE('black','#000000'));     PIPE ROW(COLOR_HEX_CODE('white','#FFFFFF'));     PIPE ROW(COLOR_HEX_CODE('red','#FF0000'));     PIPE ROW(COLOR_HEX_CODE('green','#00FF00'));     PIPE ROW(COLOR_HEX_CODE('blue','#0000FF'));     RETURN; END; 

测试:
Sql代码
  1. select * from table( f_pipeline_test );  

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

例2:实现split函数功能
Sql代码
  1. CREATE OR REPLACE TYPE RESOLVE_STR IS TABLE OF VARCHAR2 (4000);  
CREATE OR REPLACE TYPE RESOLVE_STR IS TABLE OF VARCHAR2 (4000); 

Sql代码
  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;  
CREATE OR REPLACE FUNCTION F_SPLIT     (        P_STR       IN   VARCHAR2,        P_DELIMITER IN   varchar2      ) RETURN RESOLVE_STR PIPELINED AS     j     INT := 0;     i     INT := 1;     len   INT := 0;     len1  INT := 0;     tmp   VARCHAR2 (4000);     v_str VARCHAR2 (4000); BEGIN     v_str := TRIM(BOTH P_DELIMITER FROM P_STR);--去掉前后的分隔符     len := LENGTH (v_str);     len1 := LENGTH(P_DELIMITER);      WHILE j < len       LOOP           j := INSTR (v_str, P_DELIMITER, i);--寻分隔符位置            IF j = 0 THEN--没有了               tmp := SUBSTR (v_str, i);               PIPE ROW (tmp);               EXIT;--结束           ELSE               tmp := SUBSTR (v_str, i, j - i);               i := j + len1;               PIPE ROW (tmp);           END IF;       END LOOP;      RETURN; END; 

测试:
Sql代码
  1. SELECT * FROM TABLE (F_SPLIT('-12-02-ab-cd-a0-ef-', '-'));  
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
Sql代码
  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;  
select r from (        select r from (               select rownum r from all_objects where rownum < 50                      ) order by dbms_random.VALUE               )where rownum <= 6; 

pipelined function
Sql代码
  1. CREATE OR REPLACE TYPE ARRAY AS TABLE OF NUMBER;  
CREATE OR REPLACE TYPE ARRAY AS TABLE OF NUMBER; 

Sql代码
  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;  
CREATE OR REPLACE FUNCTION gen_numbers(n IN NUMBER DEFAULT NULL) RETURN ARRAY PIPELINED AS   BEGIN     FOR i IN 1 .. nvl(n,9999)     LOOP     PIPE ROW(i);     END LOOP;   RETURN; END; 

测试:
Sql代码
  1. select * from (  
  2.   select *  
  3.     from (select * from table(gen_numbers(49)))  order by dbms_random.random  
  4.   )  
  5. where rownum <= 6  
select * from (   select *     from (select * from table(gen_numbers(49)))  order by dbms_random.random   ) where rownum <= 6 

generating that range of dates
Sql代码
  1. select to_date('2009-5-10','yyyy-mm-dd') + column_value-1 from TABLE(gen_numbers(15));  
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
Sql代码
  1. CREATE OR REPLACE TYPE date_array AS TABLE OF DATE;  
CREATE OR REPLACE TYPE date_array AS TABLE OF DATE; 

Sql代码
  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;  
CREATE OR REPLACE FUNCTION date_table(sdate DATE, edate DATE) RETURN date_array PIPELINED AS BEGIN   FOR i IN 0 .. (edate - sdate)   LOOP     PIPE ROW(sdate + i);   END LOOP;   RETURN; END date_table; 

 

转载于:https://www.cnblogs.com/RobotTech/archive/2011/01/14/1935771.html

<think>嗯,用户之前问过关于在Oracle PL/SQL中使用MEMBER OF时出现的错误,现在他们又向询问Oracle中的TABLE函数用法。我需要先确定用户的使用场景和需求。可能他们在处理集合类型数据,比如嵌套或VARRAY,想要将这类数据换为SQL中可以查询的形式。 用户可能是开发人员或DBA,需要处理存储过程中的集合数据,或者需要将PL/SQL中的集合与SQL语句结合使用。比如,他们可能想将内存中的集合数据作为来查询,或者在SQL语句中直接使用PL/SQL集合,这时TABLE函数就派上用场了。 我需要先回忆TABLE函数的基本用法。TABLE函数的主要作用是将集合类型(嵌套或VARRAY)换为可在SQL中使用的行集。常见的使用场景包括在SQL中处理PL/SQL集合,或者在查询中使用函数返回的集合结果。 接下来要考虑用户可能遇到的问题。比如,他们可能在使用TABLE函数时遇到类型不匹配错误,或者未正确初始化集合。另外,用户可能对TABLE函数在管道函数Pipelined Functions)中的应用感兴趣,或者如何结合动态SQL使用。 需要分步骤介绍TABLE函数的用法,包括基本语法、处理嵌套、VARRAY、关联数组的限制、结合管道函数使用以及动态SQL中的应用。同时,要指出常见的错误和解决方法,比如类型不匹配、集合未初始化等。 还要注意用户可能对性能优化有需求,比如使用CAST函数换类型,或者使用BULK COLLECT提高效率。需要给出实际的代码示例,帮助用户更好地理解如何应用TABLE函数。 最后,总结适用场景和注意事项,确保用户能够正确使用TABLE函数,避免常见的错误,并了解其在不同Oracle版本中的支持情况。</think>--- ### 一、`TABLE`函数核心作用 **Oracle的`TABLE()`函数** 用于将 **集合类型数据**(嵌套、VARRAY)换为标准的 **行集(rowset)**,使其能在SQL语句中像普通一样被查询。主要用途包括: - 解析PL/SQL集合数据 - 处理函数返回的集合结果 - 实现内存数据与SQL交互 --- ### 二、基础语法结构 ```sql SELECT * FROM TABLE(collection_expression) [WHERE conditions]; ``` **关键要求**: 1. `collection_expression`必须是 **嵌套或VARRAY**(关联数组不支持) 2. 集合类型需在数据库级别定义(使用`CREATE TYPE`) --- ### 三、具体使用场景与示例 #### 场景1:解析PL/SQL嵌套 **步骤说明**: ```sql -- 1. 创建数据库级别类型 CREATE TYPE num_tab IS TABLE OF NUMBER; -- 必须用CREATE TYPE定义 -- 2. PL/SQL块中使用 DECLARE nums num_tab := num_tab(10, 20, 30); -- 初始化嵌套 BEGIN -- 3. 通过TABLE函数查询 FOR rec IN (SELECT * FROM TABLE(nums) WHERE column_value > 15) LOOP DBMS_OUTPUT.PUT_LINE('值: ' || rec.column_value); END LOOP; END; ``` **输出结果**: ``` 值: 20 值: 30 ``` #### 场景2:处理函数返回的集合 ```sql -- 创建返回集合的函数 CREATE FUNCTION get_employees(dept_id NUMBER) RETURN num_tab IS emp_ids num_tab; BEGIN SELECT employee_id BULK COLLECT INTO emp_ids FROM employees WHERE department_id = dept_id; RETURN emp_ids; END; -- 在SQL中直接使用 SELECT e.* FROM TABLE(get_employees(60)) t JOIN employees e ON t.column_value = e.employee_id; ``` #### 场景3:与Pipelined函数结合 ```sql -- 1. 创建流水线函数 CREATE TYPE emp_rec IS OBJECT (id NUMBER, name VARCHAR2(50)); CREATE TYPE emp_tab IS TABLE OF emp_rec; CREATE FUNCTION gen_emps RETURN emp_tab PIPELINED IS BEGIN PIPE ROW(emp_rec(1, 'Alice')); PIPE ROW(emp_rec(2, 'Bob')); RETURN; END; -- 2. 查询流水线结果 SELECT * FROM TABLE(gen_emps()); ``` **输出**: ``` ID | NAME 1 | Alice 2 | Bob ``` --- ### 四、高级用法与技巧 #### 1. 动态SQL中的使用 ```sql DECLARE l_sql VARCHAR2(1000); l_tab num_tab := num_tab(100,200,300); BEGIN l_sql := 'SELECT * FROM TABLE(:1) WHERE column_value > :2'; EXECUTE IMMEDIATE l_sql USING l_tab, 150; END; ``` #### 2. 多列集合处理 ```sql CREATE TYPE emp_info AS OBJECT ( emp_id NUMBER, emp_name VARCHAR2(50) ); CREATE TYPE emp_info_tab IS TABLE OF emp_info; SELECT t.* FROM TABLE(emp_info_tab(emp_info(1,'Alice'), emp_info(2,'Bob'))) t WHERE t.emp_id > 1; ``` --- ### 五、常见错误与解决方案 | 错误类型 | 错误示例 | 解决方法 | |--------------------------|----------------------------------------|---------------------------------------------| | **PLS-00642** | 使用本地类型(非CREATE TYPE) | 必须用`CREATE TYPE`定义集合类型 | | **ORA-22905** | 访问未通过TABLE()换的集合 | 确保使用`TABLE()`函数包裹集合变量 | | **ORA-00902** | 错误使用关联数组 | 改用嵌套或VARRAY | | **ORA-06531** | 未初始化的集合变量 | 使用构造函数初始化:`num_tab(1,2,3)` | --- ### 六、性能优化建议 1. **批量处理**:使用`BULK COLLECT`填充集合 ```sql SELECT employee_id BULK COLLECT INTO emp_ids FROM employees; ``` 2. **内存控制**:通过`LIMIT`子句限制集合大小 ```sql DECLARE CURSOR c_emp IS SELECT * FROM employees; TYPE emp_tab IS TABLE OF employees%ROWTYPE; emps emp_tab; BEGIN OPEN c_emp; LOOP FETCH c_emp BULK COLLECT INTO emps LIMIT 1000; EXIT WHEN emps.COUNT = 0; -- 处理逻辑 END LOOP; END; ``` 3. **类型换**:使用`CAST`处理复杂类型 ```sql SELECT * FROM TABLE(CAST(plsql_var AS schema_name.collection_type)); ``` --- ### 七、版本兼容性说明 | 功能特性 | 支持版本 | 注意事项 | |-------------------------|----------------|----------------------------| | 嵌套支持 | Oracle 8i+ | 必须使用CREATE TYPE定义 | | VARRAY支持 | Oracle 8i+ | 最大长度需预先定义 | | 流水线函数 | Oracle 9i+ | 需声明PIPELINED关键字 | | 动态SQL中的TABLE() | Oracle 10g+ | 需使用USING绑定变量 | --- 通过合理使用`TABLE()`函数,可以实现PL/SQL与SQL的高效数据交互,特别适用于内存数据处理、复杂结果集解析等场景。使用时需特别注意类型定义和初始化问题。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值