VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

显式游标

功能描述

显式游标主要用于对查询语句的处理,尤其是在查询结果为多条记录的情况下。

处理步骤

显式游标处理需六个PL/pgSQL步骤(定义静态游标->打开静态游标->提取游标数据->对该记录进行处理->继续处理->关闭游标)如下所示:

1、定义静态游标:就是定义一个游标名,以及与其相对应的SELECT语句。

定义静态游标的语法图,请参见下图。

static_cursor_define::=

参数说明:

  • cursor_name

    定义的游标名。

  • parameter

    游标参数,只能为输入参数,其格式为:

    parameter_name datatype
    
  • select_statement

    查询语句。

  • 根据执行计划的不同,系统会自动判断该游标是否可以用于以倒序的方式检索数据行。
  • 语法上支持parameter为输出参数,但其行为与输入参数保持一致。

定义动态游标:指ref游标,可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型,然后定义该游标类型的游标变量,在打开游标时通过OPEN FOR动态绑定SELECT语句。

定义动态游标的语法图,请参见下图。

cursor_typename::=

dynamic_cursor_define::=

2、打开静态游标:

  • 在A兼容模式下,就是执行游标所对应的SELECT语句,将其查询结果放入工作区,并且指针指向工作区的首部,标识游标结果集合。如果游标查询语句中带有FOR UPDATE选项,OPEN语句还将锁定数据库表中游标结果集合对应的数据行。
  • 在其他兼容模式下,仅对表加RowShareLock,如果游标查询语句中带有FOR UPDATE选项,打开静态游标不会锁定游标结果集合对应的数据行,提取游标数据时才会对结果集的数据行加排它锁。

打开静态游标的语法图,请参见下图。

open_static_cursor::=

打开动态游标:可以通过OPEN FOR语句打开动态游标,动态绑定SQL语句。

打开动态游标的语法图,请参见下图。

open_dynamic_cursor::=

PL/pgSQL程序不能用OPEN语句重复打开一个游标。

3、提取游标数据:检索结果集合中的数据行,放入指定的输出变量中。

提取游标数据的语法图,请参见下图。

fetch_cursor::=

4、对该记录进行处理。

5、继续处理,直到活动集合中没有记录。

6、关闭游标:当提取和处理完游标结果集合数据后,应及时关闭游标,以释放该游标所占用的系统资源,并使该游标的工作区变成无效,不能再使用FETCH语句获取其中数据。关闭后的游标可以使用OPEN语句重新打开。

关闭游标的语法图,请参见下图。

close_cursor::=

属性

游标的属性用于控制程序流程或者了解程序的状态。当运行DML语句时,PL/pgSQL打开一个内建游标并处理结果,游标是维护查询结果的内存中的一个区域,游标在运行DML语句时打开,完成后关闭。显式游标的属性为:

  • %FOUND布尔型属性:当最近一次读记录时成功返回,则值为TRUE。

  • %NOTFOUND布尔型属性:与%FOUND相反。

  • %ISOPEN布尔型属性:当游标已打开时返回TRUE。

  • %ROWCOUNT数值型属性:返回已从游标中读取的记录数。