本文内容
- SQL 游标属性
- 使用指南
SQL 游标由 PL/SQL 自动管理。你不用写代码来处理这些游标。你可以通过 SQL 游标的属性来追踪一个游标的执行信息。
本文示例使用的表，位于 Oracle OE Schema 示例。另外，示例在 SQL*PLUS 下运行。示例最后 "/" 符号可让 SQL*PLUS 编译代码；而在 PL/SQL Developer 下则可有可无。
SQL 游标属性
SQL 游标的属性返回 DML 和 DDL 语句的执行信息，如 INSERT、UPDATE、DELETE、SELECT INTO、COMMIT 或 ROLLBACK 语句。游标的属性是 %FOUND、%ISOPEN、%NOTFOUND 和 %ROWCOUNT。游标属性的值总是引用最近执行的 SQL 语句。在数据库打开 SQL 游标前，它们的属性为 NULL。SQL 游标的另一个属性 %BULK_ROWCOUNT 是为 FORALL 语句设计的。参考 。
%FOUND 属性：一个 DML 语句改变了行？
一个 SQL 数据操纵语句执行前，%FOUND 为 NULL。之后，若一个 INSERT、UPDATE、DELETE 语句影响一个或多个行，或一个返回一个或多个行的 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 相反。
若一个 INSERT、UPDATE、DELETE 语句没有影响任何行，或一个没有返回行的 SELECT INTO 语句，则 %NOTFOUND 为 TRUE；否则为 FALSE。
%ROWCOUNT 属性：受影响的行有多少？
%ROWCOUNT 为一个受 INSERT、UPDATE、DELETE 语句，或 SELECT INTO 语句影响的行的数量。
若一个 INSERT、UPDATE、DELETE 语句，或 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，因此没必要检查。
