SQL - CURSOR_STATUS() 函数



SQL 的CURSOR_STATUS()函数用于确定当前游标的状态。在调用游标之前,应用程序可以使用此函数检查其状态。尤其是在应用程序使用一个或多个游标时。必须记住此函数的非确定性。因此,结果可能会根据情况而变化。

SQL 的CURSOR_STATUS()函数返回如下所示的smallint值:

返回值 游标名称 游标变量
1 游标结果至少有一行。 已分配给此变量的游标已打开。
0 游标结果集为空。 已分配给此变量的游标已打开,但结果肯定为空。
-1 游标已关闭。 已分配给此变量的游标已关闭。
-2 不适用。 先前调用的过程未将游标分配给此OUTPUT变量。
-3 指定名称的游标不存在。 已分配给此变量ID的游标不存在,或者如果存在,则尚未为其分配游标。

语法

以下是SQL CURSOR_STATUS()函数的语法:

CURSOR_STATUS   
   (  
      { 'local' , 'cursor_name' }   
      | { 'global' , 'cursor_name' }   
      | { 'variable' , 'cursor_variable' }   
   )

参数

  • local − 指示游标源是本地游标名称。

  • cursor_name − 指示游标的名称,必须符合数据库标识符规则。

  • global − 指示游标源是全局游标名称。

  • variable − 指示游标源是局部变量。

  • cursor_variable − 指示游标的名称,使用th定义

示例

让我们创建一个名为Workers的表,我们将在下面的示例中使用它,使用以下查询:

CREATE TABLE Workers(
   ID   INT              NOT NULL,
   NAME VARCHAR (20)     NOT NULL,
   AGE  INT              NOT NULL,
   ADDRESS  CHAR (25) ,
   SALARY   DECIMAL (18, 2),       
   PRIMARY KEY (ID)
);

现在,让我们使用INSERT语句在Workers表中插入一些记录,如下面的查询所示:

INSERT INTO Workers VALUES (1, 'Ramesh', 32, 'Ahmedabad', 2000.00 );
INSERT INTO Workers VALUES (2, 'Khilan', 25, 'Delhi', 1500.00 );
INSERT INTO Workers VALUES (3, 'kaushik', 23, 'Kota', 2000.00 );
INSERT INTO Workers VALUES (4, 'Chaitali', 25, 'Mumbai', 6500.00 );
INSERT INTO Workers VALUES (5, 'Hardik', 27, 'Bhopal', 8500.00 );
INSERT INTO Workers VALUES (6, 'Komal', 22, 'MP', 4500.00 );

验证

让我们使用以下查询检查表是否已成功创建:

SELECT * FROM Workers;

输出

执行上述查询后,将生成如下所示的输出:

+----+----------+-----+-----------+---------+
| ID | NAME     | AGE | ADDRESS   | SALARY  |
+----+----------+-----+-----------+---------+
|  1 | Ramesh   |  32 | Ahmedabad | 2000.00 |
|  2 | Khilan   |  25 | Delhi     | 1500.00 |
|  3 | kaushik  |  23 | Kota      | 2000.00 |
|  4 | Chaitali |  25 | Mumbai    | 6500.00 |
|  5 | Hardik   |  27 | Bhopal    | 8500.00 |
|  6 | Komal    |  22 | MP        | 4500.00 |
+----+----------+-----+-----------+---------+

示例

在下面的示例中,我们将为上面创建的Workers表创建游标,并使用以下查询获取状态:

DECLARE work CURSOR  FOR 
SELECT AGE,ADDRESS FROM Workers
SELECT CURSOR_STATUS ('global','work') AS 'After declare'

输出

当我们执行上述查询时,将获得如下输出:

+---------------+
| After declare |
+---------------+
|           -1  |
+---------------+

示例

让我们来看下面的示例,我们将打开游标并使用以下查询获取状态:

OPEN work
SELECT CURSOR_STATUS('global','work') AS 'After Open'

输出

当我们执行上述查询时,将获得如下输出:

+------------------------------------+
|                         After Open |
+------------------------------------+
|                                 1  |
+------------------------------------+

示例

让我们来看另一个查询,我们将关闭查询并使用以下查询检查状态:

CLOSE work
SELECT CURSOR_STATUS('global','work') AS 'After Close'

输出

执行上述查询后,将显示如下输出:

+------------------------------------+
|                        After Close |
+------------------------------------+
|                                 -1 |
+------------------------------------+

示例

让我们来看下面的查询,我们将执行fetch_status并在游标变量中读取所有行,使用以下查询:

SELECT CURSOR_STATUS('global','work') AS 'isValid?'

输出

执行上述查询后,将显示如下输出:

+-------------------+      
|          isValid? |
+-------------------+
|              -1   |
+-------------------+

示例

让我们来看下面的查询,我们将使用以下查询释放游标:

DEALLOCATE work

输出

执行上述查询后,将显示如下输出:

Commands completed successfully.
sql-cursor-functions.htm
广告