管道函数(pipelined function)简单使用示例

-----------------------------Cryking原创------------------------------
-----------------------转载请注明出处,谢谢!------------------------

管道函数是一种比较特殊的函数,其返回值为集合类型.

在PL/SQL中,管道函数和表函数、游标一起联合使用能实现一些比较复杂的功能,当和并行处理一起使用时,还能较大的改善性能.

使用示例1：

实现简单的字符串分割,函数参数为常见的VARCHAR2类型.

--先创建集合类型,供管道函数返回使用

23:38:14 SCOTT@orcl> CREATE OR REPLACE TYPE EMP_element as table of varchar2(100);
23:54:04   2  /

Type created.

Elapsed: 00:00:00.11

建立管道函数

create or replace function pipe_test(p_empno varchar2,
                                     p       varchar2 default ',')
  return EMP_element
  pipelined is
  v_element varchar2(1000) := p_empno;
begin
  pipe row(substr(p_empno, 0, instr(p_empno, p) - 1));
  loop
    v_element := substr(v_element,
                        instr(v_element, p) + 1,
                        length(v_element) - instr(v_element, p) + 1);
    exit when instr(v_element, p) = 0;
    pipe row(substr(v_element, 0, instr(v_element, p) - 1));
  end loop;
  pipe row(v_element);
  return;
end pipe_test;

注意pipelined及pipe row等关键字.

pipelined表明该函数为管道函数,pipe row用来立即返回单个元素.

使用如下:

01:06:16 SCOTT@orcl>  select pipe_test(empno||','||ename) a from emp;

A
------------------------------
EMP_ELEMENT('7369', 'SMITH')
EMP_ELEMENT('7499', 'ALLEN')
EMP_ELEMENT('7521', 'WARD')
EMP_ELEMENT('7566', 'JONES')
EMP_ELEMENT('7654', 'MARTIN')
EMP_ELEMENT('7698', 'BLAKE')
EMP_ELEMENT('7782', 'CLARK')
EMP_ELEMENT('7788', 'SCOTT')
EMP_ELEMENT('7839', 'KING')
EMP_ELEMENT('7844', 'TURNER')
EMP_ELEMENT('7876', 'ADAMS')
EMP_ELEMENT('7900', 'JAMES')
EMP_ELEMENT('7902', 'FORD')
EMP_ELEMENT('7934', 'MILLER')

14 rows selected.

Elapsed: 00:00:00.04

即每一行为一个集合变量.

也可以通过表函数查询单个集合元素的值:(这里可看作一种单行转单列的应用)

01:07:28 SCOTT@orcl>  select * from table( select pipe_test(empno||','||ename) A
 from emp where empno=7788);

COLUMN_VALUE
--------------------------------------------------
7788
SCOTT

2 rows selected.

Elapsed: 00:00:00.01

使用示例2：

使用集合类型做函数传入参数类型.

建立函数如下:

create or replace function pipe_test1(c_empno EMP_element,
                                      p       varchar2 default ',')
  return EMP_element
  pipelined is
  v_element varchar2(1000);
begin
  for i in 1 .. c_empno.count loop
    v_element := c_empno(i);
    pipe row(substr(v_element, 0, instr(v_element, p) - 1));
    loop
      v_element := substr(v_element,
                          instr(v_element, p) + 1,
                          length(v_element) - instr(v_element, p) + 1);
      exit when instr(v_element, p) = 0;
      pipe row(substr(v_element, 0, instr(v_element, p) - 1));
    end loop;
    pipe row(v_element);
  end loop;
  return;
end pipe_test1;

注意嵌套表类型的使用.

使用与上面的基本类似:

01:13:16 SCOTT@orcl> col a format a50
01:13:22 SCOTT@orcl> select pipe_test1(EMP_element(ename||','||'ename',empno||',
'||'empno')) a from emp;

A
--------------------------------------------------
EMP_ELEMENT('SMITH', 'ename', '7369', 'empno')
EMP_ELEMENT('ALLEN', 'ename', '7499', 'empno')
EMP_ELEMENT('WARD', 'ename', '7521', 'empno')
EMP_ELEMENT('JONES', 'ename', '7566', 'empno')
EMP_ELEMENT('MARTIN', 'ename', '7654', 'empno')
EMP_ELEMENT('BLAKE', 'ename', '7698', 'empno')
EMP_ELEMENT('CLARK', 'ename', '7782', 'empno')
EMP_ELEMENT('SCOTT', 'ename', '7788', 'empno')
EMP_ELEMENT('KING', 'ename', '7839', 'empno')
EMP_ELEMENT('TURNER', 'ename', '7844', 'empno')
EMP_ELEMENT('ADAMS', 'ename', '7876', 'empno')
EMP_ELEMENT('JAMES', 'ename', '7900', 'empno')
EMP_ELEMENT('FORD', 'ename', '7902', 'empno')
EMP_ELEMENT('MILLER', 'ename', '7934', 'empno')

14 rows selected.

Elapsed: 00:00:00.01

01:14:02 SCOTT@orcl> select * from table(select pipe_test1(EMP_element(ename||',
'||'ename',empno||','||'empno')) from emp where empno=7788);

COLUMN_VALUE
--------------------------------------------------
SCOTT
ename
7788
empno

4 rows selected.

Elapsed: 00:00:00.02

还可以用游标做管道函数的传入参数类型,这里就不演示了,留给大家自己去练习！

管道函数使用注意项:

1.返回类型必须是集合类型,否则会报错:PLS-00630

2.在声明部分(定义部分)不能使用管道函数(也不能定义管道函数),否则会报错:PLS-00653