Returning 子句的使用 (附录 bulk collect)---20180206

——Part 1 

在对数据表进行dml操作(InsertUpdatedelete)的时候,有时会需要获取到进行操作的数据。最简单的方法就是在DML操作之前或者之后进行一下select操作,将数据获取到。此外,还可以使用一种更为简洁的方法,就是使用Oracle SQLreturning into子句。

 

Returning Into简介

 

在进行insertupdatedelete操作的时候,都可以在末尾加入returning into字句。这字句的作用是将进行DML操作影响到数据行的列值,保存进指定的PL/SQL变量中。使用该字句的效果,与进行insertupdate之后执行select into,以及在delete之前进行select into的效果相同。在Oracle官方的PL/SQL指导书中,推荐这种方法进行变量保存,能够最大限度的保证数据的一致。

 

下面我们通过一系列的代码示例进行说明。

 

实验环境准备

 

//10g的数据库环境

SQL> select * from v$version;

 

BANNER

----------------------------------------------------------------

Oracle Database 10g Enterprise Edition Release 10.2.0.1.0 - Prod

PL/SQL Release 10.2.0.1.0 - Production

CORE       10.2.0.1.0 Production

 

TNS for 32-bit Windows: Version 10.2.0.1.0 - Production

NLSRTL Version 10.2.0.1.0 - Production

 

SQL> drop table t;

SQL> create table t as select * from dba_objects;

SQL> select count(*) from t;

 

  COUNT(*)

----------

     53300

 

 

 

单行变量returning into实验

 

returning单行数据pl/sql变量,是我们最常用的一种使用。下面的pl/sql匿名块分别从insertupdatedelete三个方面进行实验。

 

set serveroutput on size 1000;

 

declare

  v_object_id t.object_id%type;

  v_object_name t.object_name%type;

  v_object_type t.object_type%type;

begin

  --add a record

  insert into t

  (object_id, object_name)

  values

  (seq_t.nextval, 'MyTest')

  returning object_id, object_name, object_type

  into v_object_id, v_object_name, v_object_type;

 

  dbms_output.put_line('New Record Returning : id='||v_object_id

                       ||' name='||v_object_name

                       ||' type='||nvl(v_object_type,'null'));

 

  --update a record

  update t

  set object_id=20000

  where object_id=1000

  returning object_id, object_name, object_type

  into v_object_id, v_object_name, v_object_type;

 

  dbms_output.put_line('Mod Record Returning : id='||v_object_id

                       ||' name='||v_object_name

                       ||' type='||nvl(v_object_type,'null'));

 

  --delete a record(Empty record)--删除一行不存在数据的时候,观察反映。

  delete t

  where object_id=1000

  returning object_id, object_name, object_type

  into v_object_id, v_object_name, v_object_type;

 

  dbms_output.put_line('Del Record Returning : id='||v_object_id

                       ||' name='||v_object_name

                       ||' type='||nvl(v_object_type,'null'));

 

  --delete a record (Not Empty Record)

  delete t

  where object_id=2000

  returning object_id, object_name, object_type

  into v_object_id, v_object_name, v_object_type;

 

  dbms_output.put_line('Del Record Returning : id='||v_object_id

                       ||' name='||v_object_name

                       ||' type='||nvl(v_object_type,'null')); 

 

  --回退操作

  rollback;

end;

/

 

上面代码,共包括四个实验项目。分别为:

1、  添加一行记录,返回指定列表达式给一系列的pl/sql变量;

2、  修改一行存在的数据记录,返回指定列表表达式给一系列的pl/sql变量;

3、  删除一行不存在的数据记录,同样returning into给变量;

4、  删除一行存在的数据记录,返回结果;

 

上述代码执行结果为:

SQL>

 

New Record Returning : id=100008 name=MyTest type=null

Mod Record Returning : id=20000 name=V_$BUFFER_POOL_STATISTICS type=VIEW

Del Record Returning : id=20000 name=V_$BUFFER_POOL_STATISTICS type=VIEW

Del Record Returning : id=2000 name=GV_$AW_LONGOPS type=VIEW

 

PL/SQL procedure successfully completed

 

 

结果分析:

 

1、  insert操作,returning子句成功的将结果列的值返回给pl/sql变量;

2、  update操作,returning子句则是将修改过的值返回给变量;

3、  delete一条不存在记录,returning字句表现的很诡异了。首先,对应的pl/sql变量取值没有被flush intonull,还是保留着原有的变量值!其次,如果是一般的select into 变量值,在没有一行返回值的情况下,会报错。而此处的returning子句没有抛出异常,只是简单的没有赋值;

4、  delete一条存在的记录,returning记录实现了将删除信息返回给pl/sql变量的作用;

 

结论:在文档中对returning子句的阐述,效果为insertupdate之后进行selectdelete之前进行select。实际测试的结果,在特殊情况下,还有一些区别需要注意!

 

 

Type类型into支持

 

into后面的对象,除了使用简单的pl/sql变量外,还可以使用如type的记录类型。修改脚本如下:

 

set serveroutput on size 1000;

 

declare

  type t_type is record (v_id t.object_id%type,

                         v_name t.object_name%type,

                         v_type t.object_type%type);

                        

  v_object_id t.object_id%type;

  v_object_name t.object_name%type;

  v_object_type t.object_type%type;

 

  v_t_type t_type;

 

begin

  --add a record

  insert into t

  (object_id, object_name)

  values

  (seq_t.nextval, 'MyTest')

  returning object_id, object_name, object_type

  into v_t_type;

 

  dbms_output.put_line('New Record Returning : id='||v_t_type.v_id

                       ||' name='||v_t_type.v_name

                       ||' type='||nvl(v_t_type.v_type,'null'));

 

  --update a record

  update t

  set object_id=20000

  where object_id=1000

  returning object_id, object_name, object_type

  into v_t_type;

 

  dbms_output.put_line('Mod Record Returning : id='||v_t_type.v_id

                       ||' name='||v_t_type.v_name

                       ||' type='||nvl(v_t_type.v_type,'null'));

 

/*  v_object_id := null;

  v_object_name := null;

  v_object_type := null;*/

 

  --delete a record(Empty record)

  delete t

  where object_id=1000

  returning object_id, object_name, object_type

  into v_t_type;

 

  dbms_output.put_line('Del Record Returning : id='||v_t_type.v_id

                       ||' name='||v_t_type.v_name

                       ||' type='||nvl(v_t_type.v_type,'null'));

 

  --delete a record (Not Empty Record)

  delete t

  where object_id=2000

  returning object_id, object_name, object_type

  into v_t_type;

 

  dbms_output.put_line('Del Record Returning : id='||v_t_type.v_id

                       ||' name='||v_t_type.v_name

                       ||' type='||nvl(v_t_type.v_type,'null')); 

 

  --回退操作

  rollback;

end;

/

 

输出结果为:

 

SQL>

 

New Record Returning : id=100009 name=MyTest type=null

Mod Record Returning : id=20000 name=V_$BUFFER_POOL_STATISTICS type=VIEW

Del Record Returning : id=20000 name=V_$BUFFER_POOL_STATISTICS type=VIEW

Del Record Returning : id=2000 name=GV_$AW_LONGOPS type=VIEW

 

PL/SQL procedure successfully completed

 

 

结论:returning intotype的支持是效果很好的,提供了很强的代码简洁性。但是对delete空记录的问题依然存在!;



——Part 2

 

Returning bulk collect into子句支持批量

 

 

当进行DML操作的数据集合为批量多行的时候,可以使用bulk collect into进行结果集合收集。如果进行dml操作的结果集合为多行,但是使用returning into子句到变量,Oracle会报错。

set serveroutput on size 1000;

 

declare

  v_object_id t.object_id%type;

  v_object_name t.object_name%type;

  v_object_type t.object_type%type;

begin

 

  --update a record

  update t

  set object_id=20000

  where object_type='SEQUENCE'

  returning object_id, object_name, object_type

  into v_object_id, v_object_name, v_object_type; ---多条记录!

 

  dbms_output.put_line('Mod Record Numbers : numbers='||to_char(t_infos.count));

 

  --回退操作

  rollback;

end;

/

 

系统返回结果

ORA-01422: 实际返回的行数超出请求的行数

ORA-06512: 在 line 15

 

 

此时,就需要使用returning bulk collect into子句。

set serveroutput on size 1000;

 

declare

  type t_type is record (v_id t.object_id%type,

                         v_name t.object_name%type,

                         v_type t.object_type%type);

  type t_list is table of t_type index by binary_integer;

                        

  v_object_id t.object_id%type;

  v_object_name t.object_name%type;

  v_object_type t.object_type%type;

 

  t_infos t_list; 

begin

 

  --update a record

  update t

  set object_id=20000

  where object_type='SEQUENCE'

  returning object_id, object_name, object_type

  bulk collect into t_infos;

 

  dbms_output.put_line('Mod Record Numbers : numbers='||to_char(t_infos.count));

 

  --delete a record(Empty record)

  delete t

  where object_type='TTT'

  returning object_id, object_name, object_type

  bulk collect into t_infos;

 

  dbms_output.put_line('Del Record Numbers : numbers='||to_char(t_infos.count));

 

  --delete a record (Not Empty Record)

  delete t

  where object_type='SEQUENCE'

  returning object_id, object_name, object_type

  bulk collect into t_infos;

 

  dbms_output.put_line('Del Record Numbers : numbers='||to_char(t_infos.count));

   

  --回退操作

  rollback;

end;

/

 

相同的实验结构,包括三个方面。

1、  批量更新多条记录;

2、  删除多条不存在记录;

3、  删除多条记录;

系统返回结果。

SQL>

 

Mod Record Numbers : numbers=340

Del Record Numbers : numbers=0

Del Record Numbers : numbers=340

 

PL/SQL procedure successfully completed

 

 

结果很明显。值得关注的就是对不存在记录的DML操作,系统会正确返回结果。

 

 

Forallreturning

 

Oracle官方文档中,包括如下阐述。

 

If you put an UPDATE statement with a RETURNING clause in a FORALL statement, you

can retrieve values from a set of updated rows into a collection of records.

 

简单含义说明ForallReturning关系,介绍如何在forall结构中使用returningForall语句可以对循环体中的SQL语句进行一次性批量提交,大大减少PL/SQL引擎与SQL引擎的切换次数(Oracle官方解释),提高性能。但是使用forall是有很多限制,首先forall结构体中只能包括一条SQL语句,而且使用数组成员必须为简单类型等。

 

forall中,是可以使用returning的,将变量返回给数据对象。

 

实验代码如下:

set serveroutput on size 1000;

 

declare

   type t_rowids is table of urowid index by binary_integer;

   type t_ids is table of t.object_id%type index by binary_integer;

   type t_names is table of t.object_name%type index by binary_integer;

   

   t_rowids_infos t_rowids;

   t_ids_infos t_ids;

   t_names_infos t_names;

  

begin 

  --Get rowid List

  select rowid

  bulk collect into t_rowids_infos

  from t

  where rownum<1000;

 

  --update

  forall i in 1..t_rowids_infos.count

     update t

     set object_id=object_id

     where rowid=t_rowids_infos(i)

     returning object_name bulk collect into t_names_infos;

 

  dbms_output.put_line('Update Nums : '||to_char(t_names_infos.count));

 

  --delete

  forall i in 1..t_rowids_infos.count

     delete t where rowid=t_rowids_infos(i)

     returning object_name bulk collect into t_names_infos;

    

  dbms_output.put_line('Del Nums : '||to_char(t_names_infos.count));

 

  --回退操作

  rollback;

end;

/

 

实验代码中进行了更新和删除两种操作,在forall结构中直接调用returning XX bulk collect into <数组对象>,就可以直接将所有的更新影响过的记录输入到其中。

 

试验结果如下:

SQL>

 

Update Nums : 999

Del Nums : 999

 

PL/SQL procedure successfully completed

 

 

 

select into  returning

 

最后,我们一起看下select into子句和returning结合的情况。

set serveroutput on size 1000;

 

declare

   type t_ids is table of t.object_id%type index by binary_integer;

   t_ids_infos t_ids;  

begin 

  --Get rowid List

  insert into t

  select * from dba_objects

  returning object_id bulk collect into t_ids_infos;

 

  --回退操作

  rollback;

end;

/

 

试验结果如下:

 

ORA-06550: 第 14 行, 第 13 列:

PL/SQL: ORA-00933: SQL 命令未正确结束

ORA-06550: 第 12 行, 第 3 列:

PL/SQL: SQL Statement ignored

 

 

看来returning子句和insert into结构是不能轻易一起使用的。这可能与定位记录方式有一些关系。



----Part3  bulk 附录

 BULK COLLECT 子句会批量检索结果,即一次性将结果集绑定到一个集合变量中,并从SQL引擎发送到PL/SQL引擎。通常可以在SELECT INTO、
FETCH INTO以及RETURNING INTO子句中使用BULK COLLECT。本文将逐一描述BULK COLLECT在这几种情形下的用法。
    有关FORALL语句的用法请参考:批量SQL之 FORALL 语句

 

一、BULK COLLECT批量绑定的示例

[sql]  view plain  copy
 print ?
  1. --下面的示例中使用了BULK COLLECT将得到的结果集绑定到记录变量中        
  2. DECLARE  
  3.    TYPE emp_rec_type IS RECORD          --声明记录类型  
  4.    (  
  5.       empno      emp.empno%TYPE  
  6.      ,ename      emp.ename%TYPE  
  7.      ,hiredate   emp.hiredate%TYPE  
  8.    );  
  9.   
  10.    TYPE nested_emp_type IS TABLE OF emp_rec_type;  --声明记录类型变量   
  11.   
  12.    emp_tab   nested_emp_type;  
  13. BEGIN  
  14.    SELECT empno, ename, hiredate  
  15.    BULK   COLLECT INTO emp_tab       --使用BULK COLLECT 将所得的结果集一次性绑定到记录变量emp_tab中  
  16.    FROM   emp;  
  17.   
  18.    FOR i IN emp_tab.FIRST .. emp_tab.LAST  
  19.    LOOP  
  20.       DBMS_OUTPUT.put_line('Current record is '||emp_tab(i).empno||chr(9)||emp_tab(i).ename||chr(9)||emp_tab(i).hiredate);  
  21.    END LOOP;  
  22. END;  
  23. --上面的例子可以通过FOR 循环和普通的SELECT INTO来实现,那两者之间的差异呢?  
  24. --差异是FOR循环的SELECT INTO逐行提取并绑定到记录变量,而BULK COLLECT则一次即可提取所有行并绑定到记录变量。即谓批量绑定。  

二、使用LIMIT限制FETCH数据量
    在使用BULK COLLECT 子句时,对于集合类型,如嵌套表,联合数组等会自动对其进行初始化以及扩展(如下示例)。因此如果使用BULK 
COLLECT子句操作集合,则无需对集合进行初始化以及扩展。由于BULK COLLECT的批量特性,如果数据量较大,而集合在此时又自动扩展,为避
免过大的数据集造成性能下降,因此使用limit子句来限制一次提取的数据量。limit子句只允许出现在fetch操作语句的批量中。

    用法:
        FETCH ... BULK COLLECT INTO ... [LIMIT rows]

[sql]  view plain  copy
 print ?
  1. DECLARE  
  2.    CURSOR emp_cur IS  
  3.       SELECT empno, ename, hiredate FROM emp;  
  4.   
  5.    TYPE emp_rec_type IS RECORD  
  6.    (  
  7.       empno      emp.empno%TYPE  
  8.      ,ename      emp.ename%TYPE  
  9.      ,hiredate   emp.hiredate%TYPE  
  10.    );  
  11.   
  12.    TYPE nested_emp_type IS TABLE OF emp_rec_type;   -->定义了基于记录的嵌套表  
  13.   
  14.    emp_tab     nested_emp_type;           -->定义集合变量,此时未初始化  
  15.    v_limit     PLS_INTEGER := 5;          -->定义了一个变量来作为limit的值  
  16.    v_counter   PLS_INTEGER := 0;  
  17. BEGIN  
  18.    OPEN emp_cur;  
  19.   
  20.    LOOP  
  21.       FETCH emp_cur  
  22.       BULK   COLLECT INTO emp_tab         -->fetch时使用了BULK COLLECT子句  
  23.       LIMIT v_limit;                      -->使用limit子句限制提取数据量  
  24.   
  25.       EXIT WHEN emp_tab.COUNT = 0;        -->注意此时游标退出使用了emp_tab.COUNT,而不是emp_cur%notfound  
  26.       v_counter   := v_counter + 1;       -->记录使用LIMIT之后fetch的次数  
  27.   
  28.       FOR i IN emp_tab.FIRST .. emp_tab.LAST  
  29.       LOOP  
  30.          DBMS_OUTPUT.put_line( 'Current record is '||emp_tab(i).empno||CHR(9)||emp_tab(i).ename||CHR(9)||emp_tab(i).hiredate);  
  31.       END LOOP;  
  32.    END LOOP;  
  33.   
  34.    CLOSE emp_cur;  
  35.   
  36.    DBMS_OUTPUT.put_line( 'The v_counter is ' || v_counter );  
  37. END;  

三、RETURNING 子句的批量绑定
    BULK COLLECT除了与SELECT,FETCH进行批量绑定之外,还可以与INSERT,DELETE,UPDATE语句结合使用。当与这几个DML语句结合时,我们
需要使用RETURNING子句来实现批量绑定。

[sql]  view plain  copy
 print ?
  1. --下面示例中从表emp中删除所有deptno=20的记录  
  2. DECLARE  
  3.    TYPE emp_rec_type IS RECORD  
  4.    (  
  5.       empno      emp.empno%TYPE  
  6.      ,ename      emp.ename%TYPE  
  7.      ,hiredate   emp.hiredate%TYPE  
  8.    );  
  9.   
  10.    TYPE nested_emp_type IS TABLE OF emp_rec_type;  
  11.   
  12.    emp_tab   nested_emp_type;  
  13. --   v_limit   PLS_INTEGER := 3;  
  14. --   v_counter   PLS_INTEGER := 0;  
  15. BEGIN  
  16.    DELETE FROM emp  
  17.    WHERE  deptno = 20  
  18.    RETURNING empno, ename, hiredate     -->使用returning 返回这几个列  
  19.    BULK   COLLECT INTO emp_tab;         -->将前面返回的列的数据批量插入到集合变量    
  20.   
  21.    DBMS_OUTPUT.put_line( 'Deleted ' || SQL%ROWCOUNT || ' rows.' );  
  22.    COMMIT;  
  23.      
  24.    IF emp_tab.COUNT > 0 THEN                 -->当集合变量不为空时,输出所有被删除的元素  
  25.       FOR i IN emp_tab.FIRST .. emp_tab.LAST       
  26.       LOOP  
  27.          DBMS_OUTPUT.  
  28.           put_line(  
  29.                        'Current record  '  
  30.                     || emp_tab( i ).empno  
  31.                     || CHR( 9 )  
  32.                     || emp_tab( i ).ename  
  33.                     || CHR( 9 )  
  34.                     || emp_tab( i ).hiredate  
  35.                     || ' has been deleted' );  
  36.       END LOOP;  
  37.    END IF;  
  38. END;  

四、FORALL与BULK COLLECT 综合运用
    FORALL与BULK COLLECT是实现批量SQL的两个重要方式,我们可以将其结合使用以提高性能。下面的示例即是两者的总和运用。

[sql]  view plain  copy
 print ?
  1. DROP TABLE tb_emp;  
  2.   
  3. CREATE TABLE tb_emp AS                        -->创建表tb_emp  
  4.    SELECT empno, ename, hiredate  
  5.    FROM   emp  
  6.    WHERE  1 = 2;  
  7.   
  8. DECLARE                                 
  9.    CURSOR emp_cur IS                          -->声明游标   
  10.       SELECT empno, ename, hiredate FROM emp;  
  11.   
  12.    TYPE nested_emp_type IS TABLE OF emp_cur%ROWTYPE;  -->基于游标的嵌套表类型  
  13.   
  14.    emp_tab   nested_emp_type;                         -->声明嵌套变量  
  15. BEGIN  
  16.    SELECT empno, ename, hiredate  
  17.    BULK   COLLECT INTO emp_tab                        -->BULK  COLLECT批量提取数据  
  18.    FROM   emp  
  19.    WHERE  sal > 1000;  
  20.   
  21.    FORALL i IN 1 .. emp_tab.COUNT                     -->使用FORALL语句将变量中的数据插入到表tb_emp  
  22.       INSERT INTO (SELECT empno, ename, hiredate FROM tb_emp)  
  23.       VALUES emp_tab( i );  
  24.   
  25.    COMMIT;  
  26.    DBMS_OUTPUT.put_line( 'The total ' || emp_tab.COUNT || ' rows has been inserted to tb_emp' );  
  27. END;  

五、BULK COLLECT的限制
1、不能对使用字符串类型作键的关联数组使用BULK COLLECT 子句。
2、只能在服务器端的程序中使用BULK COLLECT,如果在客户端使用,就会产生一个不支持这个特性的错误。
3、BULK COLLECT INTO 的目标对象必须是集合类型。
4、复合目标(如对象类型)不能在RETURNING INTO 子句中使用。
5、如果有多个隐式的数据类型转换的情况存在,多重复合目标就不能在BULK COLLECT INTO 子句中使用。
6、如果有一个隐式的数据类型转换,复合目标的集合(如对象类型集合)就不能用于BULK COLLECTINTO 子句中。


  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值