2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

CLOSE

CLOSE — 关闭游标

概要

CLOSE { name | ALL }

描述

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

所有非保持性(non-holdable)的打开游标在事务通过 COMMITROLLBACK 终止时会被隐式关闭。保持性(holdable)游标如果在创建它的事务中通过 ROLLBACK 被中止,则会被隐式关闭。如果创建事务成功提交,则保持性游标将保持打开状态,直到执行显式的 CLOSE 或客户端断开连接。

参数

name

要关闭的已打开游标的名称。

ALL

关闭所有已打开的游标。

注释

PostgreSQL 没有显式的 OPEN 游标语句;当声明游标时,它就被认为是打开的。使用 DECLARE 语句来声明一个游标。

您可以通过查询 pg_cursors 系统视图来查看所有可用的游标。

如果一个游标在设置了保存点(savepoint)之后被关闭,而该保存点之后又被回滚(rolled back),那么 CLOSE 操作不会被回滚;也就是说,游标将保持关闭状态。

示例

关闭游标 liahona

CLOSE liahona;

兼容性

CLOSE 完全符合 SQL 标准。CLOSE ALLPostgreSQL 的一个扩展。

另请参阅

DECLARE, FETCH, MOVE

提交更正

如果您在文档中发现任何不正确的内容,与您在使用特定功能时的经验不符,或者需要进一步澄清,请使用 此表单 报告文档问题。