CLOSE
关闭一个游标
英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。
当前阅读 PG 18·选择有来源记录的版本
- anchor
- SQL-CLOSE
- file
- sql-close.html
- lang
- en
- name
- CLOSE
- purpose
- close a cursor
- purpose zh
- 未知
- sections same as
- 未知
- slug
- 18
- synopsis html
- CLOSE { <em class="replaceable"><code>name</code></em> | ALL }
- synopsis text
- CLOSE { name | ALL }
语法
CLOSE { name | ALL }语法图
从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。
版本定义 PG 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的一种扩展。
另见
DECLARE, FETCH, MOVE比较版本
来源引用
定义来源
center · PostgreSQL 18 · a709ab85
正文语言: zh-Hans · 1b5ca64c