2012年7月29日星期日

Oracle 11g Release 1 (11.1) 游标SQL 游标(隐式)

Oracle 11g Release 1 (11.1) 游标SQL 游标(隐式)

http://docs.oracle.com/cd/B28359_01/appdev.111/b28370/static.htm#i46192

 

本文内容

  • SQL 游标属性
  • 使用指南

SQL 游标由 PL/SQL 自动管理。你不用写代码来处理这些游标。你可以通过 SQL 游标的属性来追踪一个游标的执行信息。

本文示例使用的表,位于 Oracle OE Schema 示例。另外,示例在 SQL*PLUS 下运行。示例最后 "/" 符号可让 SQL*PLUS 编译代码;而在 PL/SQL Developer 下则可有可无。

SQL 游标属性


SQL 游标的属性返回 DML 和 DDL 语句的执行信息,如 INSERTUPDATEDELETESELECT INTOCOMMITROLLBACK 语句。游标的属性是 %FOUND、%ISOPEN%NOTFOUND%ROWCOUNT。游标属性的值总是引用最近执行的 SQL 语句。在数据库打开 SQL 游标前,它们的属性为 NULL。SQL 游标的另一个属性 %BULK_ROWCOUNT 是为 FORALL 语句设计的。参考 Counting Rows Affected by FORALL (%BULK_ROWCOUNT 属性)。

%FOUND 属性:一个 DML 语句改变了行?

一个 SQL 数据操纵语句执行前,%FOUND 为 NULL。之后,若一个 INSERTUPDATEDELETE 语句影响一个或多个行,或一个返回一个或多个行的 SELECT INTO 语句,则 %FOUND 为 TRUE;否则为 FALSE。

示例 1:演示 SQL%FOUND。若删除成功,则插入一行。

CREATE TABLE dept_temp AS SELECT * FROM departments;
DECLARE
  dept_no NUMBER(4) := 270;
BEGIN
  DELETE FROM dept_temp WHERE department_id = dept_no;
  IF SQL%FOUND THEN
    -- delete succeeded
    INSERT INTO dept_temp VALUES (270, 'Personnel', 200, 1700);
  END IF;
END;
/
%ISOPEN 属性:对 SQL 游标一直为 FALSE

当与 SQL 语句相关的游标执行后,数据库会自动关闭 SQL 游标。因为是自动关闭,所以 %ISOPEN 总为 FALSE。

%NOTFOUND 属性:一个 DML 语句没有改变行?

%NOTFOUND%FOUND 相反。

若一个 INSERTUPDATEDELETE 语句没有影响任何行,或一个没有返回行的 SELECT INTO 语句,则 %NOTFOUND 为 TRUE;否则为 FALSE。

%ROWCOUNT 属性:受影响的行有多少?

%ROWCOUNT 为一个受 INSERTUPDATEDELETE 语句,或 SELECT INTO 语句影响的行的数量。

若一个 INSERTUPDATEDELETE 语句,或 SELECT INTO 语句没有影响任何行,则 %ROWCOUNT 为 0。

示例 2:演示 SQL%ROWCOUNT。演示 %ROWCOUNT 返回删除行的数量。

CREATE TABLE employees_temp AS SELECT * FROM employees;
DECLARE
  mgr_no NUMBER(6) := 122;
BEGIN
  DELETE FROM employees_temp WHERE manager_id = mgr_no;
  DBMS_OUTPUT.PUT_LINE('Number of employees deleted: ' ||
                       TO_CHAR(SQL%ROWCOUNT));
END;
/

输出:

Number of employees deleted: 8

SELECT INTO 语句返回多个行,则 PL/SQL 产生预定义异常 TOO_MANY_ROWS,%ROWCOUNT 为 1,并不是满足查询真实的数据行的数量。

SQL%ROWCOUNT 的值从 PL/SQL 引用最近执行的 SQL 语句。为之后的使用保存属性的值,并把该值立刻分配给一个本地变量。

SQL%ROWCOUNT 属性与一个事务的状态无关。当回滚到保存点完成时,SQL%ROWCOUNT 的值不能恢复到保存点之前的原始值。另外,当一个匿名事务退出时,SQL%ROWCOUNT 在父事务中不能被恢复到原来的值。

 

使用指南


当使用 SQL 游标的属性时,考虑:

  • 无论 SQL 语句在哪里执行,游标属性的值总是引用最近执行的 SQL 语句。语句可能位于不同的作用域,如在一个子块。为之后的使用保存属性值,把该值立刻分配给一个本地变量。其他操作,如子程序调用,可能会改变该变量的值。
  • %NOTFOUND 属性与 SELECT INTO 语句结合是意义的。

若一个 SELECT INTO 语句没有返回行,则 PL/SQL 立即产生预定义的异常 NO_DATA_FOUND,检查 %NOTFOUND 后,中断控制流。

一个调用 SQL 聚合函数的 SELECT INTO 语句总是返回一个值或 null。执行这样的语句后,%NOTFOUND 总是返回 FALSE,因此没必要检查。


TAG: