预发布版本文档。 PostgreSQL 19beta4 为测试版本,最终发布内容可能有所不同。
CLOSE
CLOSE — 关闭一个游标
大纲
CLOSE { name | ALL }
描述
CLOSE 释放与一个打开的游标相关联的资源。游标关闭后,不允许再对其执行任何后续操作。当不再需要游标时,应将其关闭。
每个不可保持的打开游标都会在事务通过 COMMIT 或
ROLLBACK 结束时被隐式关闭。可保持游标会在创建它的事务通过 ROLLBACK 中止时被隐式关闭。如果创建它的事务成功提交,则该可保持游标会一直保持打开状态,直到显式执行
CLOSE,或者客户端断开连接。
注解
PostgreSQL 没有显式的 OPEN 游标语句;游标在声明时即被视为打开。请使用 DECLARE 语句来声明游标。
可以通过查询 pg_cursors
系统视图查看所有可用游标。
如果在某个保存点之后关闭了游标,而该保存点后来又被回滚,则 CLOSE 不会被回滚;也就是说,该游标仍然保持关闭状态。
示例
关闭游标 liahona:
CLOSE liahona;
兼容性
CLOSE 完全符合 SQL 标准。CLOSE ALL 是 PostgreSQL 的一种扩展。