人大金仓数据库KingbaseES PLSQL 隐式游标介绍

金仓数据库KingbaseES PLSQL 隐式游标介绍

关键字：

KingbaseES、PLSQL、隐式游标、人大金仓、KingbaseES

随着企业数据的不断增长，数据库管理系统变得愈发重要。KingbaseES数据库作为一种广泛应用的关系型数据库管理系统，提供了多种功能来操作和处理数据。其中，游标是KingbaseES PLSQL中的一个重要特性，它提供了逐行处理查询结果的功能，从而增加了处理多行数据的灵活性。在KingbaseES中，游标又分为显式游标和隐式游标。其中，由系统创建并管理的游标是隐式游标，由用户创建并管理的游标是显式游标。本文主要介绍隐式游标。

什么是隐式游标？

隐式游标无需再由用户去显式地创建，它是由系统自动创建并管理的会话游标。在PLSQL的代码块中每次运行SELECT或者DML语句时，这些语句返回数据库中一个单独的行并直接插入PLSQL代码块的数据结构中，这时PLSQL都会自动打开一个隐式游标。这种游标之所以被称为“隐式”，是因为数据库为我们自动处理了许多游标相关的操作，例如分配一个游标，打开游标，获取记录以及关闭游标等。用户无法控制隐式游标，但是系统提供了一些隐式游标的属性，用户可以从这些属性中获取SELECT或者DML语句执行结果相关的信息。在显式游标的用法中，用户可以声明和定义一个显式游标来在循环语句中逐行处理查询结果。类似的，用户在不显式地定义游标时，仅通过使用隐式游标FOR LOOP语句就可以去逐行处理查询结果集。

隐式游标属性

KingbaseES为隐式游标提供了一些属性值，用户可以以此来查看SELECT或者DML语句的执行结果相关信息。隐式游标属性值的语法如下：

SQL%attribute

其中，attribute是具体的属性，用户可以根据需求将其写为 ISOPEN, FOUND, NOTFOUND和ROWCOUNT等。 隐式游标的属性值SQL%attribute总是跟最近运行的SELECT或DML语句相关联，如果没有运行这样的语句，则SQL%attribute的值为NULL。各个隐式游标属性代表的含义如下：

1. SQL%ISOPEN属性：游标是否打开？ 它总会返回FALSE, 因为隐式游标总是在SELECT或DML语句执行完毕后立即自动关闭；
2. SQL%FOUND属性：是否有任何行受到影响？ 如果没有运行 SELECT 或 DML 语句，则返回NULL；如果 SELECT 语句返回一行或多行，或者 DML 语句影响一行或多行，则返回TRUE，否则返回FALSE；
3. SQL%NOTFOUND属性：没有行受到影响？如果没有运行 SELECT 或 DML 语句，则为 NULL；如果 SELECT 语句返回一行或多行，或者DML语句影响一行或多行，则返回FALSE，否则返回TRUE 。
4. SQL%ROWCOUNT属性：有多少行受到影响？ 如果没有运行 SELECT 或 DML 语句，则返回NULL ; 否则，返回受SELECT 或DML 语句影响的行数；

下面是一个使用SQL%ROWCOUNT属性来显示DML语句影响了多少行的简单示例：

/*创建一个临时存储学生信息的表，并向其中插入数据*/

DROP TABLE IF EXISTS student_temp;

CREATE TABLE student_temp(id int, name varchar(100));

insert into student_temp values(1, 'simba'),(3, 'nano');

\set SQLTERM /

DECLARE

stu_no NUMBER(6) := 1;

BEGIN

DELETE FROM student_temp WHERE id >= stu_no;

/*使用SQL%ROWCOUNT属性来显示DELETE语句删除了多少行*/

RAISE NOTICE 'Number of student deleted: %', SQL%ROWCOUNT;

END;

/

执行结果：

Number of student deleted: 2

隐式游标FOR LOOP 语句

游标FOR LOOP语句支持在循环中运行SELECT语句，并通过游标去遍历查询结果集中的每一行。该语句不仅支持显式游标，而且支持隐式游标。跟显式游标不同，隐式游标FOR LOOP语句不必再由用户去语句中定义游标，而是直接将其循环索引隐式地声明为跟查询结果集相关联的记录变量，这样可以通过这个循环索引来遍历结果集中的每一行，达到跟显式游标类似的结果。

下面是一个使用隐式游标FOR LOOP语句

/*创建一个临时存储学生信息的表stu_temp*/

DROP TABLE IF EXISTS stu_temp;

CREATE TABLE stu_temp（id INT, name VARCHAR(50)）;

/*向表中插入一些数据*/

insert into stu_temp values (1001, 'xs');

insert into stu_temp values (1002, 'xd');

insert into stu_temp values (1003, 'xc');

\set SQLTERM /

BEGIN

/*隐式游标FOR LOOP语句将循环索引item隐式地声明为跟查询结果集相关联的记录 变量，这样可以通过这个循环索引item来遍历结果集中的每一行,达到跟显式游标类似 的结果*/

FOR item IN (

SELECT id, name

FROM stu_temp

WHERE id > 1000

)

LOOP

RAISE NOTICE 'id: %, name: %', item.id, item.name;

END LOOP;

END;

/

执行结果：

NOTICE: id: 1001, name: xs

NOTICE: id: 1002, name: xd

NOTICE: id: 1003, name: xc

参考资料

《KingbaseES_PLSQL过程语言参考手册》