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

# DECLARE

## 名前

DECLARE -- カーソルを定義します。

## 概要

    DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR prepared_name
    DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR query

## 説明

`DECLARE`は、プリペアード・ステートメントの結果セット全体を繰り返し処理するカーソルを宣言します。 このコマンドは直接的な`DECLARE`SQLコマンドとは多少異なる意味を持ちます。 こちらは問い合わせを実行し、取り出し用の結果セットの準備を行いますが、埋め込みSQLコマンドでは、問い合わせの結果セット全体を繰り返す"ループ変数"の名前を宣言するだけです。 実際の実行は`OPEN`コマンドでカーソルが開いた時に起こります。

## パラメータ

`cursor_name`

  カーソル名です。 大文字小文字を区別します。 これはSQL識別子またはホスト変数とすることができます。

`prepared_name`

  プリペアード・クエリの名前です。 SQL識別子またはホスト変数のいずれかです。

`query`

  このカーソルで返される行を供給するSELECTまたはVALUESコマンドです。

カーソルオプションの意味についてはDECLAREを参照してください。

## 例

以下に問い合わせ用のカーソルを宣言する例を示します。

    EXEC SQL DECLARE C CURSOR FOR SELECT * FROM My_Table;
    EXEC SQL DECLARE C CURSOR FOR SELECT Item1 FROM T;
    EXEC SQL DECLARE cur1 CURSOR FOR SELECT version();

プリペアード・ステートメント用のカーソルを宣言する例を示します。

    EXEC SQL PREPARE stmt1 AS SELECT version();
    EXEC SQL DECLARE cur1 CURSOR FOR stmt1;

## 互換性

`DECLARE`は標準SQLで規定されています。

## 関連項目

OPEN, CLOSE, DECLARE

前のページ | ホーム | 次のページ
DEALLOCATE DESCRIPTOR | 上に戻る | DESCRIBE