显式游标
- 处理步骤
- 属性

显式游标

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

处理步骤

显式游标处理需六个PL/SQL步骤：

定义静态游标：就是定义一个游标名，以及与其相对应的SELECT语句。

定义静态游标的语法图，请参见图1。

图 1 static_cursor_define::=

参数说明：
- cursor_name：定义的游标名。
- parameter：游标参数，只能为输入参数，其格式为：
```
parameter_name datatype
```
- select_statement：查询语句。

> ![](/projects/opengauss-1.0-zh/db39bcb5ce2400c61bbf2884c7a1fe0f.gif) **说明：**  
> 根据执行计划的不同，系统会自动判断该游标是否可以用于以倒序的方式检索数据行。
**定义动态游标：**指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。
定义动态游标的语法图，请参见[图2](#zh-cn_topic_0237122244_zh-cn_topic_0059778930_f1579c1867b984124b10da33d032a55b0)和[图3](#zh-cn_topic_0237122244_zh-cn_topic_0059778930_fceaf870eaa73494496e8a65e7afc8cec)。
**图 2** cursor\_typename::=  
![](/projects/opengauss-1.0-zh/a0ed91f3e7a1bd1a13398dd14323838b.png "cursor_typename")
**图 3** dynamic\_cursor\_define::=  
![](/projects/opengauss-1.0-zh/87b30f1510dfb98c2284d6bf40692a3a.png "dynamic_cursor_define")

打开静态游标：就是执行游标所对应的SELECT语句，将其查询结果放入工作区，并且指针指向工作区的首部，标识游标结果集合。如果游标查询语句中带有FOR UPDATE选项，OPEN语句还将锁定数据库表中游标结果集合对应的数据行。

打开静态游标的语法图，请参见图4。

图 4 open_static_cursor::=

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

打开动态游标的语法图，请参见图5。

图 5 open_dynamic_cursor::=

PL/SQL程序不能用OPEN语句重复打开一个游标。
提取游标数据：检索结果集合中的数据行，放入指定的输出变量中。

提取游标数据的语法图，请参见图6。

图 6 fetch_cursor::=
对该记录进行处理。
继续处理，直到活动集合中没有记录。
关闭游标：当提取和处理完游标结果集合数据后，应及时关闭游标，以释放该游标所占用的系统资源，并使该游标的工作区变成无效，不能再使用FETCH语句获取其中数据。关闭后的游标可以使用OPEN语句重新打开。

关闭游标的语法图，请参见图7。

图 7 close_cursor::=

属性

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

%FOUND布尔型属性：当最近一次读记录时成功返回，则值为TRUE。
%NOTFOUND布尔型属性：与%FOUND相反。
%ISOPEN布尔型属性：当游标已打开时返回TRUE。
%ROWCOUNT数值型属性：返回已从游标中读取的记录数。