4.30.1　OPEN文 形式2の形式と規則

(1)　機能

カーソルを開きます。DECLARE CURSORで宣言したカーソル，又はALLOCATE CURSOR文で割り当てたカーソルを，検索結果の先頭の行の直前に位置づけて，検索結果を取り出せる状態にします。

形式2では，SQL記述領域によって?パラメタに値を与えてカーソルを開きます。

ページの先頭へ

(2)　使用権限

SELECT権限を持つユーザ

カーソル宣言中やALLOCATE CURSOR文に，指定したSELECT文に含まれるすべての表に対してSELECT権限を持っている必要があります。

ページの先頭へ

(3)　形式2 <SQL記述領域によって?パラメタに値を与えてカーソルを開く場合>

　OPEN ｛カーソル名｜拡張カーソル名｝ USING DESCRIPTOR 〔：〕SQL記述領域名
                        〔CHARACTER SET〔：〕文字集合名記述領域名〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　留意事項

1. 一度開いたカーソルを再度開く場合は，いったんカーソルを閉じてから，再度開いてください。

2. 内部的にCLOSE文を発行してカーソルを閉じる契機については，「CLOSE文（カーソルクローズ）」の共通規則1を参照してください。

3. FETCH文を実行する場合は，OPEN文でカーソルを開いてから，そのカーソルに対するFETCH文を実行してください。

4. OPEN文を実行するまでに，UAPはSQL記述領域及び文字集合名記述領域に必要な情報を設定してください。SQL記述領域及び文字集合名記述領域については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

5. カーソル名は，埋込み変数名と同様に，コンパイル単位のモジュール内で有効な名前であり，同じカーソルに対する複数のSQLを，複数のモジュールにわたって使用できません。

6. 同一の表に対して，複数のホールダブルカーソルを開くことはできません。

ページの先頭へ

(6)　使用例

在庫表の検索結果を取り出すために，カーソル（CR2）を開きます。ただし，PREPARE文で前処理したSELECT文中で指定した?パラメタの値を与えるための情報（SQLDA）を指定します。

OPEN CR2
    USING DESCRIPTOR SQLDA

ページの先頭へ