金仓数据库KingabseES 隐式游标属性值(SQL_attribute)

隐式游标介绍

Oracle数据库迁移到KingbaseES数据库，不需要将源PL/SQL脚本大规模修改为KES语法，因为KingbaseES支持大部分PLSQL语法。

1、隐式游标

隐式游标是由 PL/SQL 构造和管理的会话游标。

每次运行 SELECT 或 DML 语句时，PL/SQL 都会打开一个隐式游标。您无法控制隐式游标，但可以从其属性中获取信息。

隐式游标属性值的语法是 SQL%attribute，SQL%attribute 总是指向最近运行的 SELECT 或 DML 语句。 如果没有运行这样的语句，则 SQL%attribute 的值为 NULL。隐式游标在其关联语句运行后关闭。但是，在另一个 SELECT 或 DML 语句运行之前，它的属性值仍然可用。最近运行的SELECT或DML语句可能在不同的范围内。要保存属性值以供以后使用，请立即将其分配给局部变量。 否则，其他操作(例如子程序调用)可能会在您测试之前更改属性的值。

2、隐式游标属性值的用途

隐式游标属性是：

- SQL%ISOPEN 属性：游标是否打开？
- SQL%FOUND 属性：是否有任何行受到影响？
- SQL%NOTFOUND 属性：没有行受到影响？
- SQL%ROWCOUNT 属性：有多少行受到影响？

3、简单例子

--SQL%attribute的值，可以获得最新一条DQL和DML语句的运行信息
do language plsql
$$
    declare
        i int;
    begin

        delete from oo02 where rownum <= 0;
        DBMS_OUTPUT.PUT('staSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('staSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        delete from oo02 where rownum <= 10;
        DBMS_OUTPUT.PUT('staSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('staSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

    end;
$$;

ANONYMOUS BLOCK
staSQL : 0,false,false,true
staSQL : 0

staSQL : 10,false,true,false
staSQL : 10

二、KingbaseES 隐式游标属性值的不能获得动态SQL的执行信息

1、Oracle 场景

在Oracle数据库的PLSQL语句中，动态SQL语句的执行信息，也可以通过隐式游标属性获取。

begin
    execute immediate 'delete from sch01.TT01 where rownum <= 10';
    DBMS_OUTPUT.PUT('dynSQL : ');
    DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || (case when sql % ISOPEN then 'true' else 'false' end) || ',' ||
                         (case when sql % found then 'true' else 'false' end) || ',' ||
                         (case when sql % notfound then 'true' else 'false' end));

    execute immediate 'delete from sch01.TT01 where rownum <= 0';
    DBMS_OUTPUT.PUT('dynSQL : ');
    DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || (case when sql % ISOPEN then 'true' else 'false' end) || ',' ||
                         (case when sql % found then 'true' else 'false' end) || ',' ||
                         (case when sql % notfound then 'true' else 'false' end));
    rollback;
end;


dynSQL : 10,false,true,false
dynSQL : 0,false,false,true

2、KingbaseES 场景

在KingbaseES数据库的language PLSQL的语句中，动态SQL语句的执行信息，隐式游标属性不被赋值，仍然保留上一次的数值。

do language plsql
$$
    declare
        i int;
    begin

        execute ' delete from oo02 where rownum <= :rn  ' using 20;
        DBMS_OUTPUT.PUT('dynSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('dynSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        delete from oo02 where rownum <= 0;
        DBMS_OUTPUT.PUT('staSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('staSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        execute ' delete from oo02 where rownum <= :rn  ' using 20;
        DBMS_OUTPUT.PUT('dynSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('dynSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        delete from oo02 where rownum <= 10;
        DBMS_OUTPUT.PUT('staSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('staSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        execute ' delete from oo02 where rownum <= :rn  ' using 20;
        DBMS_OUTPUT.PUT('dynSQL : ');
        DBMS_OUTPUT.PUT_LINE(sql % rowcount || ',' || sql % ISOPEN || ',' || sql % found || ',' || sql % notfound);
        GET DIAGNOSTICS i := row_count;
        DBMS_OUTPUT.PUT_LINE('dynSQL : ' || i);
        DBMS_OUTPUT.PUT_LINE(' ');

        rollback;
    end;
$$;
ANONYMOUS BLOCK
dynSQL :
dynSQL : 20

staSQL : 0,false,false,true
staSQL : 0

dynSQL : 0,false,false,true
dynSQL : 20

staSQL : 10,false,true,false

staSQL : 10

dynSQL : 10,false,true,false
dynSQL : 20

更多信息，参见https://help.kingbase.com.cn/v8/index.html