SQL COMMAND · 游标与预备语句
CLOSE
关闭一个游标
CLOSE游标与预备语句引入 10（基线）现存至 20 devel0 次语法变更
- 动词
CLOSE- 对象
—- 分组
- 游标与预备语句
- 引入版本
- 10（基线）
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。
语法概要
CLOSE { name | ALL }
描述
CLOSE释放与一个打开的游标相关联的资源。 游标关闭后，不允许再对其执行任何后续操作。 当不再需要游标时，应将其关闭。
每个不可保持的打开游标都会在事务通过COMMIT或 ROLLBACK结束时被隐式关闭。 可保持游标会在创建它的事务通过ROLLBACK中止时被隐式关闭。 如果创建它的事务成功提交，则该可保持游标会一直保持打开状态，直到显式执行 CLOSE，或者客户端断开连接。
参数
name要关闭的打开游标的名称。
ALL关闭所有打开的游标。
注解
PostgreSQL没有显式的OPEN游标语句； 游标在声明时即被视为打开。 请使用DECLARE语句来声明游标。
可以通过查询pg_cursors 系统视图查看所有可用游标。
如果在某个保存点之后关闭了游标，而该保存点后来又被回滚， 则CLOSE不会被回滚；也就是说，该游标仍然保持关闭状态。
示例
关闭游标liahona：
CLOSE liahona;
兼容性
CLOSE完全符合 SQL 标准。 CLOSE ALL是PostgreSQL的一种扩展。
另见
语法演化
相邻大版本之间的差异，新的在前。版本号链接到对应快照。
- 收录以来没有记录到变化。