DECLARE CURSOR

構文

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

 >--.-------------.-----.---------.------.--------------.--->
    +-SENSITIVE---+     +-FORWARD-+      +-LOCK---------+
    +-INSENSITIVE-+     +-KEYSET--+      +-LOCKCC-------+
                        +-DYNAMIC-+      +-OPTIMISTIC---+
                        +-STATIC--+      +-OPTCC--------+
                        +-SCROLL--+      +-OPTCCVAL-----+
                                         +-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--------><

パラメーター

db_name	DECLARE DATABASE を使用して宣言されているデータベースの名前を指定します。
cursor_name	以後の文でカーソルを示すためのカーソル名を指定します。カーソル名には、有効な任意のファイル名の文字を入れることができます。カーソル名は最大 30 字で、最初の文字は数字以外の文字にする必要があります。
select_stmt	任意の有効な SQL SELECT文、あるいは結果セットを返すストアドプロシージャの QUERY ODBC 文または CALL 文を指定します。
prepared_stmt_name	準備された SQL SELECT 文または QUERY ODBC 文の名前を指定します。
stored_procedure_call_stmt	結果セットを返す有効なストアドプロシージャを指定します。
n	カーソルオープン時に、１ブロックにつき FETCHされる行数。 1000 以下の整数で指定します。
column_list	カンマで区切られた列名のリストを指定します。

目的

DECLARE CURSOR 文により、指定された SELECT 文がカーソル名に関連付けられ、 FETCH 文を使用したデータ行を検索できます。

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

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

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

OPTIMIZE FOR 句が書かれていると、OpenESQL は PREFETCH指令の設定より優先して、該当するカーソルのFETCH行数として n を使用します。これによってプリフェッチの最適化を個々のカーソルに対して設定することができます。 PREFETCH 指令についての詳細は、データベースアクセスマニュアル中の PREFETCH の項を参照してください。

注:

SCROLL では、ドライバによってサポートされるスクロールオプションを選択します (FORWARD は除く)。
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 指令は、ネットワークトラフィックを著しく軽減するための２つの最適化策を含んでいます。比較的小さな結果セットに対してカーソルを操作する場合には、結果セットがメモリ上にキャッシュされるため、最も大きな効果を生みます。 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

DECLARE CURSOR

構文

パラメーター

目的

例:

他参照: