4.9.1　DECLARE CURSOR 形式1の形式と規則

(1)　機能

問合せ指定の検索結果をFETCH文で1行ずつ取り出すために，カーソルを宣言します。

形式1では，直接指定したカーソル指定に対するカーソルの宣言をします。

ページの先頭へ

(2)　使用権限

なし。

ページの先頭へ

(3)　形式1<直接指定したカーソル指定に対するカーソルの宣言>

　DECLARE カーソル名 CURSOR
〔WITH HOLD〕〔｛WITH RETURN ｜ WITHOUT RETURN｝〕 FOR
　〈カーソル指定　形式1〉
　　〈問合せ式〉
　　　〈問合せ指定〉
　　　｛SELECT 〔｛ALL｜DISTINCT｝〕｛選択式〔，選択式〕…｜＊｝
　　　　〈表式〉
　　　　FROM 表参照〔，表参照〕…
　　　　　　　〔WHERE  探索条件〕
　　　　　　　〔GROUP  BY  値式〔，値式〕…〕
　　　　　　　〔HAVING  探索条件〕
　　　　｜ 問合せ式 ｝
　　　　〔ORDER BY ｛列指定｜ソート項目指定番号｝〔｛ASC｜DESC｝〕
　　　　　　　〔，｛列指定｜ソート項目指定番号｝〔｛ASC｜DESC｝〕〕… 〕
　　　　〔LIMIT ｛〔オフセット行数，〕｛リミット行数｜ALL｝
　　　　　　　　｜ ｛リミット行数｜ALL｝ 〔OFFSET オフセット行数〕｝〕
　〈排他オプション〉
　　〔〔｛WITH ｛SHARE｜EXCLUSIVE｝LOCK
　　　　｜WITHOUT LOCK〔｛WAIT｜NOWAIT｝〕｝〕
　　〔｛WITH ROLLBACK｜NO WAIT｝〕〕
　　　　〔FOR｛UPDATE 〔OF列名〔，列名〕…〕〔NOWAIT〕｜READ ONLY｝〕
　　　　〔UNTIL DISCONNECT〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

1. 宣言したカーソルは，閉じた状態になります。

2. DECLARE CURSOR中のSELECT文で指定した埋込み変数，SQL変数，又はSQLパラメタの値は，カーソルを開いてからカーソルを閉じるまでこのカーソルのOPEN文実行時の値が有効です。値を変更したい場合は，いったんカーソルを閉じてから，再度開いてください。

3. 1個のUAPでは，最大1,023個のカーソルを宣言できます。

4. カーソル指定又は排他オプション中に次のどれかの指定を含む場合は，そのカーソルを使用した更新及び削除はできません。また，FOR UPDATE句の指定もできません。

   (5-a) UNION 〔ALL〕，又はEXCEPT〔ALL〕

   (5-b) 最も外側の問合せ指定のFROM句に指定した表を，副問合せのFROM句に指定

   (5-c) 最も外側の問合せ指定での表の結合

   (5-d) 最も外側の問合せ指定でのFROM句の導出表

   (5-e) 最も外側の問合せ指定でのSELECT DISTINCT

   (5-f) 最も外側の問合せ指定でのGROUP BY句

   (5-g) 最も外側の問合せ指定でのHAVING句

   (5-h) 最も外側の問合せ指定に対する集合関数

   (5-i) 最も外側の問合せ指定に対するウィンドウ関数

   (5-j) 最も外側の問合せ指定のFROM句中で，次に示すどれかのビュー表を指定

   • ビュー定義文で上記(5-a)〜(5-i)を指定して定義したビュー表

   • ビュー定義文で最も外側の問合せ指定のSELECT句に，列指定以外の値式を指定して定義したビュー表

   • ビュー定義文でREAD ONLYを指定したビュー表

   (5-k) WITHOUT LOCK NOWAIT

   (5-l) WITH句を指定した問合せ式本体の最も外側の問合せ指定のFROM句に問合せ名を指定

5. そのカーソルを指定した行の更新，又は削除がある場合FOR READ ONLY句は指定できません。

6. FOR READ ONLY句を指定した場合，次に示す制限があります。

   (5-a) 選択式中に，結果が次のデータ型になるスカラ演算，関数呼出し，及びコンポネント指定は指定できません。

   • BLOB

   • 最大長が32,001バイト以上のBINARY

   • BOOLEAN

   • 抽象データ型

   (5-b) 選択式中のWRITE指定の出力BLOB値には，列指定だけ指定できます。

   (5-c) GET_JAVA_STORED_ROUTINE_SOURCE指定は指定できません。

ページの先頭へ

(6)　参照制約に関する規則

1. ホールダブルカーソルを使用して，外部キーの定義されている表を検索している場合，検索中の表が検査保留状態となったときは，カーソルは閉じた状態になります。

ページの先頭へ

(7)　留意事項

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

2. カーソル宣言は，この宣言で使用したカーソル名を参照するどのSQL文よりも先行して記述する必要があります。

3. DECLARE CURSORは実行文ではないため，SQLCODEにリターンコードは返されません。したがって，リターンコードの判定はしないでください。

4. SQL最適化オプションの更新SQLの作業表作成抑止を適用して，更にインデクスキー値無排他機能を使用すると，FOR UPDATE又はFOR UPDATE OFを指定しないカーソルの使用中に，行の更新，追加，又は削除ができます。

5. FOR READ ONLYを指定している場合，HiRDBが作業表を作成することがあります。このとき，作業表の行長によっては，FOR READ ONLYの処理が制限されることがあります。作業表の行長については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

ページの先頭へ

(8)　使用例

1. 在庫表（ZAIKO）から，行を1行ずつ取り出すためにカーソル（CR1）を宣言します。

   DECLARE CR1 CURSOR FOR
       SELECT SCODE,SNAME,COL,TANKA,ZSURYO
           FROM ZAIKO

2. 在庫表（ZAIKO）から，単価（TANKA）が5,000円以上の行を1行ずつ取り出すためにカーソル（CR1）を宣言します。

   DECLARE CR1 CURSOR FOR
       SELECT * FROM ZAIKO
           WHERE TANKA >= 5000

3. 在庫表（ZAIKO）から，カーソル（CR1）を使用してすべての行を検索しながら単価（TANKA）を1割引にし，更に行を挿入します。

   DECLARE CR1 CURSOR FOR
       SELECT * FROM ZAIKO
           FOR UPDATE
   OPEN CR1
     FETCH CR1 INTO ＜各列を取り出す変数名＞
   UPDATE ZAIKO
       SET TANKA = ＜単価の１割引の値＞
           WHERE CURRENT OF CR1
   INSERT INTO ZAIKO VALUES(＜各列の挿入値＞)
   CLOSE CR1

4. 在庫表（ZAIKO）から，カーソル（CR1）を使用してすべての行を検索しながら単価（TANKA）を1割引にします。

   DECLARE CR1 CURSOR FOR
       SELECT * FROM ZAIKO
           FOR UPDATE OF TANKA
   OPEN CR1
   FETCH CR1 INTO ＜各列を取り出す変数名＞
   UPDATE ZAIKO
       SET TANKA = ＜単価の１割引の値＞
           WHERE CURRENT OF CR1
   CLOSE CR1

5. 在庫表（ZAIKO）からカーソル（CR1）を使用してすべての行を検索中に，カーソルを使用しないで，直接商品名（SNAME）がセーターの行を削除します。

   DECLARE CR1 CURSOR FOR
       SELECT * FROM ZAIKO
           FOR READ ONLY
   OPEN CR1
   FETCH CR1 INTO ＜各列を取り出す変数名＞
   DELETE FROM ZAIKO
       WHERE SNAME=N’セーター’
   CLOSE CR1

ページの先頭へ