PostgreSQL 8.4.1文書
前のページ | 巻戻し |  | 早送り | 次のページ

# CLOSE

## 名前

CLOSE -- カーソルを閉じる

## 概要

    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

前のページ | ホーム | 次のページ
CHECKPOINT | 上に戻る | CLUSTER