4.20.1　EXECUTE文 形式2の形式と規則

(1)　機能

PREPARE文で前処理したSQLを，配列を使用して複数行分一括して実行します。

ページの先頭へ

(2)　使用権限

なし。

ページの先頭へ

(3)　形式2 <前処理したSQL（INSERT文，UPDATE文，又はDELETE文）の複数行分又は複数回分の一括実行>

　EXECUTE ｛SQL文識別子｜拡張文名｝
　　　　　｛USING ：埋込み変数配列〔：標識変数配列〕
　　　　　　　　　　　〔，：埋込み変数配列〔：標識変数配列〕〕…
　　　　　　｜USING DESCRIPTOR 〔：〕SQL記述領域名
                      〔CHARACTER_SET〔：〕文字集合名記述領域名〕｝
　　　　　BY ：埋込み変数〔ROWS〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

1. EXECUTE文で実行するSQLは，PREPARE文で前処理しておく必要があります。

2. EXECUTE文の形式2は，PREPARE文で前処理したSQL文が次に示すINSERT文，UPDATE文，又はDELETE文の場合にだけ使用できます。

   • INSERT INTO 〔認可識別子.〕表識別子 〔（列名〔，列名〕…）〕

     ｛VALUES（挿入値〔，挿入値〕…）

     ｜ 問合せ式本体 ｝

     〔WITH ROLLBACK〕

   • INSERT INTO 〔認可識別子.〕表識別子（ROW）

     ｛VALUES（：埋込み変数配列〔：標識変数配列〕）

     ｜問合せ式本体 ｝

     〔WITH ROLLBACK〕

   • UPDATE 〔認可識別子.〕表識別子 〔〔AS〕相関名〕

     〔使用インデクスのSQL最適化指定〕

     　　SET｛更新対象＝更新値

     　　　　｜（更新対象，更新対象〔，更新対象〕）＝行副問合せ｝

     　　　　〔，｛更新対象＝更新値

     　　　　　　｜（更新対象，更新対象〔，更新対象〕…）＝行副問合せ｝〕…

     〔WHERE探索条件〕

     〔WITH ROLLBACK〕

   • UPDATE 〔認可識別子.〕表識別子 〔〔AS〕相関名〕

     〔使用インデクスのSQL最適化指定〕

     SET ROW＝行更新値

     〔WHERE探索条件〕

     〔WITH ROLLBACK〕

   • DELETE FROM 〔認可識別子.〕表識別子

     〔〔AS〕相関名〕

     〔使用インデクスのSQL最適化指定〕

     〔WHERE探索条件〕

     〔WITH ROLLBACK〕

   PREPARE文で前処理したSQL文が上記の形式でない場合，実行時にエラーとなります。

3. PREPARE文と，そのPREPARE文で前処理したSQLを実行するEXECUTE文は，同じトランザクション内で実行してください。

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

5. オペランドに"USING ：埋込み変数配列〔：標識変数配列〕〔，：埋込み変数配列〔：標識変数配列〕〕…"を指定する場合，次の規則に従ってください。

   • 埋込み変数配列，及び標識変数配列の要素数は，1〜4,096の範囲にしてください。範囲外の値を指定した場合はエラーとなります。

   • 埋込み変数配列，及び標識変数配列の要素数は，"BY ：埋込み変数〔ROWS〕"で指定する行数の最大値以上になるようにしてください。

6. オペランドに"USING DESCRIPTOR 〔：〕SQL記述領域名"を指定する場合，次の規則に従ってください。

   • SQL記述領域名で指定した，SQL記述領域のSQLDATAが指す領域に，入力？パラメタの値を設定する場合は，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。このとき，配列の要素数は，"BY ：埋込み変数〔ROWS〕"で指定する行数の最大値以上になるようにしてください。

   • SQL記述領域名で指定したSQL記述領域のSQLSYS領域に，データ型に応じた値を設定してください。

     ・可変長文字列（VARCHAR，NVARCHAR，又はMVARCHAR）の場合は，文字列の長さを格納する領域と境界調整によって生じる要素間のギャップも含めた１要素分の長さを設定してください。

     (例)

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

     　struct {

     　　　short len;

     　　　char str[257];

     　} vchr[128];

     ・ほかのデータ型の場合は，0を設定してください。

7. BLOB型，最大長が32,001バイト以上のBINARY，及び抽象データ型は指定できません。

8. USING句に指定した埋込み変数配列が既定文字集合の文字データ型で，かつ入力?パラメタの文字集合と異なる場合，自動的に入力?パラメタの文字集合に変換します。

ページの先頭へ

(6)　留意事項

1. PREPARE文で前処理した一つのSQLに対して，EXECUTE文は何回でも実行できます。

2. EXECUTE文形式2では，"BY ：埋込み変数"で指定する行数分の処理をするため，埋込み変数配列，標識変数配列，又は入力？パラメタの値を設定する，SQLDATAが指す領域には，必ず指定する行数分の値を設定しておいてください。

ページの先頭へ

(7)　使用例

1. C言語の配列変数に設定した50行分のデータを，在庫表に一括して挿入します。

   EXEC SQL BEGIN DECLARE SECTION;
     short   XINSERT_NUM;
     long    XSCODE[50];
     short   ISCODE[50];
     char    XSNAME[50][17];
     short   ISNAME[50];
   EXEC SQL END DECLARE SECTION;
    
   EXEC SQL
     PREPARE PRESQL FROM
         'INSERT INTO ZAIKO(SCODE, SNAME) VALUES (?, ?)';
    
                    :
       各変数配列の要素に値を設定
                    :
    
   XINSERT_NUM = 50;
   EXEC SQL
     EXECUTE PRESQL USING :XSCODE:ISCODE, :XSNAME:ISNAME
         BY :XINSERT_NUM ROWS;

2. C言語の配列変数に設定した商品コード（SCODE）及び在庫量（ZSURYO）の値別に，在庫量（ZSURYO）を次の表で示す値に更新します。

   表4‒5　表に格納された商品コードと在庫量（更新前）

   商品コード	在庫量の更新値
   '101M'	40
   '101L'	70
   '201M'	15
   '202M'	28
   '302S'	7

   表4‒6　更新対象となる行の商品コードと在庫量（埋込み変数配列に設定）

   商品コード	在庫量の更新値
   '101M'	35
   '101L'	62
   '201M'	13
   '202M'	10
   '302S'	6

   表4‒7　表に格納された商品コードと在庫量（更新後）

   商品コード	在庫量の更新値
   '101M'	35
   '101L'	62
   '201M'	13
   '202M'	10
   '302S'	6

   EXEC SQL BEGIN DECLARE SECTION;
         short   XUPDATE_NUM;
         char    XSCODE[5][5];
         short   ISCODE[5];
         long    XZSURYO[5];
         short   IZSURYO[5];
   EXEC SQL END DECLARE SECTION;
   EXEC SQL
   PREPARE PRESQL FROM
         'UPDATE ZAIKO SET ZSURYO = ? WHERE SCODE = ?';
       ・・・各変数配列の要素に値設定・・・
           XSCODEに{'101M','101L','201M','202M','302S'}を設定
           XZSURYOに{35,62,13,10,6}を設定
   XUPDATE_NUM = 5;
   EXEC SQL
   EXECUTE PRESQL USING :XZSURYO:IZSURYO, :XSCODE:ISCODE
   BY :XUPDATE_NUM

ページの先頭へ