4.23.1　FETCH文 形式2の形式と規則

(1)　機能

検索結果中の1行，又は複数行を，SQL記述領域に指定した受け取り領域に読み込みます。

ページの先頭へ

(2)　使用権限

なし。

ページの先頭へ

(3)　形式2 <検索結果中の1行，又は複数行を，SQL記述領域に指定した受け取り領域に読み込む>

　FETCH ｛カーソル名｜拡張カーソル名｝
       USING DESCRIPTOR 〔：〕SQL記述領域名
                    〔CHARACTER_SET〔：〕文字集合名記述領域名〕
　　　　 〔BY ：埋込み変数〔ROWS〕〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

1. FETCH文で指定するカーソルは，ALLOCATE CURSOR文 形式2（結果集合カーソルの割当て）で割り当てた場合以外は，OPEN文で開いておいてください。

2. UAPがFETCH文を実行するときに必要な情報は，SQL記述領域名で指定したSQL記述領域中に設定しておいてください。SQL記述領域については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

3. 取り出す行がない場合，次のリターンコードが設定されます。

   • SQL連絡領域のSQLCODE領域に100

   • SQLCODE変数に100

   • SQLSTATE変数に’02000’

   ただし，リストを介した検索でリスト作成時にあった行が削除された場合，又は属性値が削除，更新された場合，それぞれ110,110,’R2000’が設定されます。

4. SQL記述領域で指定する受取り領域のデータ型は，対応する検索項目のデータ型と変換できるデータ型です。

5. 検索結果が文字データ型で，検索結果の文字集合が文字集合名記述領域に指定した文字集合と異なる場合，自動的に文字集合名記述領域に指定した文字集合に変換します。

6. BY ：埋込み変数〔ROWS〕を指定する場合，SQL記述領域のSQLSYSにデータ型に対応した値を設定しておく必要があります。

   • 可変長文字列（VARCHAR，NVARCHAR，又はMVARCHAR）の場合

     文字列の長さを格納する領域と，境界調整によって生じる要素間のギャップも含めた1要素分の値を設定してください。

     例えば，次のようなVARCHAR型の配列変数の場合は，SQLSYSに設定する値はsizeof(vchr[0])となります。

       struct {
           short   len;
           char    str[257];
       } vchr[128];

   • ほかのデータ型の場合

     0を設定してください。

ページの先頭へ

(6)　留意事項

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

ページの先頭へ

(7)　使用例

カーソル（CR2）による在庫表の検索結果を，SQL記述領域に指定した受け取り領域に読み込みます。

FETCH CR2
    USING DESCRIPTOR SQLDA

ページの先頭へ