DECLARE CURSOR

指定した SELECT 文でカーソル名を関連付けて、FETCH 文を使用してデータ行を取得できるようになります。

構文、書き方 1：

>>--EXEC SQL---.------------.------DECLARE cursor_name------>
               +-AT db_name-+

 >--.-------------.-----.---------.------.--------------.--->
    +-SENSITIVE---+     +-FORWARD-+      +-LOCK---------+
    +-INSENSITIVE-+     +-KEYSET--+      +-LOCKCC-------+
                        +-DYNAMIC-+      +-OPTIMISTIC---+
                        +-STATIC--+      +-OPTCC--------+
                        +-SCROLL--+      +-OPTCCVAL-----+
                        +-DATASET-+      +-READ ONLY----+
                                         +-READONLY-----+
                                         +-FASTFORWARD--+
                                         +-FAST FORWARD-+

 >--CURSOR-------.----------------.---------FOR------------->
                 +----WITH HOLD---+

 >----.----select_stmt-----------------------.-------------->
      +----stored_procedure_call_statement---+
      +----prepared_stmt_name----------------+
      +----OPTIMIZE FOR n ROWS---------------+
 >--.-------------------------------.----------------------->
    +-FOR READ ONLY-----------------+
    +-FOR UPDATE-.----------------.-+
                 +-OF column_list-+
 >------END-EXEC--------><

構文、書き方 2：

注: 書き方 2 は、SQL Server でのみサポートされています。

>>--EXEC SQL---.------------.------DECLARE cursor_name------>
               +-AT db_name-+
 >--CURSOR FOR---result-set-generating-dml-statement-------->

 >------END-EXEC--------><

パラメーター：

AT `db_name`	DECLARE DATABASE を使用して宣言されたデータベースの名前。注: DECLARE CURSOR で AT `db_name` を使用する必要がある場合、カーソルを参照する後続の文の接続が現在の接続と異なっていると、カーソルに関連付けられている接続に自動的に切り替わります。これは、この文の実行中のみ有効です。
`cursor_name`	後続の文でカーソルを指定するために使用するカーソル名。カーソル名には、ファイル名として使用できる文字を 30 字まで含められます。最初の文字は英字とします。
`select_stmt`	任意の有効な SQL SELECT 文、または結果セットを返すストアドプロシージャの QUERY ODBC 文か CALL 文。
`prepared_stmt_name`	準備された SQL SELECT 文または QUERY ODBC 文の名前。
`stored_procedure_call_stmt`	結果セットを返す有効なストアドプロシージャ呼び出し。
`n`	カーソルを開く際にフェッチされるブロックごとの行数。`n` の値は 1000 未満とします。
`column_list`	カンマで区切られた列名のリスト。
`result-set-generating-dml-statement`	OUTPUT 句を含む SQL Server INSERT、位置決めされていない UPDATE、または DELETE 文。

説明：

別々にコンパイルされた 2 つのプログラムでは、同じカーソルを共有できません。特定のカーソルを参照する文はすべて、まとめてコンパイルする必要があります。

DECLARE CURSOR 文は、最初のカーソル参照よりも前に記述する必要があります。SELECT 文は、カーソルを開く際に実行されます。SELECT 文には次の規則が適用されます。

INTO 句またはパラメーターマーカーを含めることはできません。
前に宣言節で指定した入力ホスト変数を含めることは可能です。
ODBC ドライバーによっては、位置指定更新または位置指定削除を実行する場合に、SELECT 文に FOR UPDATE 句を指定する必要があります。

OPTIMIZE FOR を指定すると、OpenESQL が n を使用してカーソルの PREFETCH 指令の設定をオーバーライドします。これにより、個々のカーソルで事前取り込みを最適化できます。

DECLARE CURSOR 文で複数の SELECT 文を指定することができます。これは、次のいずれかから複数の結果セットが返されることを示します。いずれの場合もクライアントアプリケーションで追加の結果セットを取得するには GET NEXT RESULT SET 文を使用する必要があります。

DIALECT=MAINFRAME を使用してコンパイルされていない SQL Server 用 COBOL ストアドプロシージャ
標準の OpenESQL アプリケーションプログラム

次の内容は、DECLARE CURSOR の特定のオプションの動作に当てはまります。

SCROLL では、ドライバーでサポートされるスクロールオプションを選択します (FORWARD は除く)。
DATASET を使用すると、任意の BEHAVIOR 設定で使用できるカーソルが有効になります。DATASET は、他の .NET 言語と相互運用するための基本的な .NET オブジェクトを使用するアプリケーションでは必須であり、OpenESQL Managed Runtime でのみ使用できます。
LOCKCC および LOCK は同義です。
READ ONLY および READONLY は同義です。
OPTIMISTIC では、ドライバーによってサポートされるオプティミスティック同時実行モード (OPTCC または OPTCCVAL) を選択します。
HOLD カーソルが要求され、現在の接続でカーソルがトランザクションの終わりで閉じられる場合には、OPEN 文はエラー (SQLCODE = -19520) を返します。
データベースが Microsoft SQL Server で、NOANSI92 ENTRY 指令設定が使用されている場合 (この設定がデフォルト) は、Microsoft SQL Server 固有の ODBC 呼び出しが接続時に行われ、カーソルがトランザクションの終わりで閉じないように要求されます。この動作は、Micro Focus Embedded SQL Toolkit for Microsoft SQL Server と互換性があります。USECURLIB の設定は、YES にしないでください。
FAST FORWARD および FASTFORWARD は同義です。これは、FORWARD および READ-ONLY カーソルにのみ適用されるパフォーマンス最適化パラメーターです。また、AUTOFETCH 指令を使用してプログラムをコンパイルすると、パフォーマンスをさらに向上させることができます。この方法は、アプリケーションに結果セットを取り込む最も効率的な方法です。AUTOFETCH 指令を使用すると、ネットワークトラフィックを大幅に減少できる 2 つの最適化が有効になります。パフォーマンスが最も向上するのは、アプリケーションのメモリにキャッシュできるサイズの比較的小さい結果セットを使用してカーソルを処理する場合です。FASTFORWARD カーソルは、Microsoft SQL Server 2000 以降のサーバーでのみ使用できます。

例：

EXEC SQL DECLARE C1 CURSOR FOR
   SELECT last_name, first_name FROM staff
END-EXEC

EXEC SQL DECLARE C2 CURSOR FOR
   QUERY ODBC COLUMNS TABLENAME 'staff'
END-EXEC