CLOSE

关闭游标。

概要

CLOSE { <cursor_name> | ALL }

描述

CLOSE 释放与打开的游标关联的资源。 关闭游标后,不允许对其进行后续操作。 不再需要游标时,应将其关闭。

当事务通过 COMMIT 或 ROLLBACK 终止时,每个非持有的打开游标都会隐式关闭。 如果创建游标的事务通过 ROLLBACK 中止,则该游标将隐式关闭。 如果创建事务成功提交,则持有的游标将保持打开状态,直到执行了显式 CLOSE 或客户端断开连接为止。

参数

  • ursor_name
    • 要关闭的已打开游标的名称。
  • ALL
    • 关闭所有已打开的游标。

注意

游标在声明时即被视为打开状态。使用DECLARE语句可声明(并打开)游标。

若游标在保存点之后关闭,而该保存点随后被回滚,则CLOSE操作不会被回滚;即游标保持关闭状态。

示例

关闭游标 portala:

CLOSE portala;

兼容性

CLOSE 完全服从 SQL 标准。 CLOSE ALL 是一种 YMatrix 扩展。

另见

DECLARE, FETCH, MOVE, RETRIEVE