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

提交更正

如果您在文件中發現任何不正確的內容,與您在使用特定功能時的經驗不符,或者需要進一步澄清,請使用 此表單 報告文件問題。