文档首页/ 云数据库 GaussDB/ 开发指南（集中式_V2.0-8.x）/ 存储过程/ 游标/ 隐式游标
更新时间：2024-11-12 GMT+08:00
查看PDF
分享

隐式游标

对于非查询语句，如修改、删除操作，则由系统自动地为这些操作设置游标并创建其工作区，这些由系统隐含创建的游标称为隐式游标，隐式游标的名称为SQL，这是由系统定义的。

简介

对于隐式游标的操作，如定义、打开、取值及关闭操作，都由系统自动地完成，无需用户进行处理。用户只能通过隐式游标的相关属性，来完成相应的操作。在隐式游标的工作区中，所存放的数据是最新处理的一条SQL语句所包含的数据，与用户自定义的显式游标无关。

格式调用为： SQL%

  • INSERT、UPDATE、DELETE和SELECT语句中不必明确定义游标。
  • 兼容A模式下，GUC参数behavior_compat_options为compat_cursor时，隐式游标跨存储过程有效。
  • 打开SMP相关GUC参数（设置GUC参数query_dop为大于1的值，plsql_beta_feature = 'enable_plsql_smp'）后，游标中不涉及INSERT、UPDATE和DELETE的查询语句可以选择SMP执行。
  • 隐式游标属性不受commit\rollback操作影响。打开GUC参数set behavior_compat_options='compat_cursor'时，隐式游标属性受savepoint\commit\rollback操作影响，将重置相关属性为默认值。

属性

隐式游标属性为：

  • SQL%FOUND布尔型属性：当最近一次读记录时成功返回，则值为TRUE。
  • SQL%NOTFOUND布尔型属性：当最近一次读记录时失败返回，则值为TRUE。
  • SQL%ROWCOUNT数值型属性：返回已从游标中读取的记录数。
  • SQL%ISOPEN布尔型属性：取值总是FALSE。SQL语句执行完毕立即关闭隐式游标。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
--删除员工表hr.staffs中某部门的所有员工，如果该部门中已没有员工，则在部门表hr.department中删除该部门。
gaussdb=# CREATE OR REPLACE PROCEDURE proc_cursor3() 
AS 
    DECLARE
    V_DEPTNO NUMBER(4) := 100;
    BEGIN
        DELETE FROM hr.staffs WHERE section_id = V_DEPTNO;
        --根据游标状态做进一步处理
        IF SQL%NOTFOUND THEN
        DELETE FROM hr.department WHERE section_id = V_DEPTNO;
        END IF;
    END;
/
CREATE PROCEDURE
gaussdb=# CALL proc_cursor3();
 proc_cursor3 
--------------

(1 row)

--删除存储过程和临时表
gaussdb=# DROP PROCEDURE proc_cursor3;
DROP PROCEDURE
-- 如果需要SELECT隐式游标并发执行，需要打开以下GUC参数
gaussdb=# SET query_dop=4;
SET
gaussdb=# SET sql_beta_feature= 'enable_plsql_smp';

-- 选择员工表hr.staffs中工号为1的员工姓名
gaussdb=# CREATE OR REPLACE PROCEDURE prc_cursor_smp()
AS
    name varchar(20);
BEGIN
   SELECT first_name FROM hr.staffs WHERE staff_id = 1 INTO name;
   dbe_output.print_line('result is: '|| name);
END;
/
CREATE PROCEDURE
-- 执行存储过程
gaussdb=# CALL prc_cursor_smp();
result is: Tom
 prc_cursor_smp 
----------------

(1 row)
父主题： 游标

相关文档