4.19.1　EXECUTE文 形式1の形式と規則

(1)　機能

PREPARE文で前処理したSQLを実行します。

ページの先頭へ

(2)　使用権限

なし。

ページの先頭へ

(3)　形式1 <前処理したSQL文の実行>

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

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

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

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

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

4. INTO句で指定する埋込み変数の数と，EXECUTE文で実行する1行SELECT文の検索結果の列の数，又はCALL文の出力?パラメタの数を同じにしてください。実行するSQLが1行SELECT文の場合，埋込み変数の数と，列の数が同じでないときは，SQL連絡領域のSQLWARN3領域に警告フラグ”W”が設定されます。なお，埋込み変数と検索結果の列，又は埋込み変数と出力?パラメタは，それぞれ並びの順に先頭から対応付けられます。

5. INTO句で指定する埋込み変数のデータ型は，対応する検索結果の列，又は出力?パラメタに対して許されるデータ型にしてください。

6. INTO句で指定する固定長文字列（各国文字列，及び混在文字列を含む）の埋込み変数に取り出すデータが，その埋込み変数の定義長より短い場合は，左詰めに挿入され，余りの部分に空白が設定されます。

7. 検索結果の列の値又はCALL文の出力?パラメタの値がナル値の場合，対応する埋込み変数の値は保証しません。

8. INTO句に指定した埋込み変数が既定文字集合の文字データ型でかつ，検索結果の列又はCALL文の出力?パラメタの文字集合が異なる文字データ型の場合，自動的に埋込み変数の文字集合に変換します。

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

ページの先頭へ

(6)　留意事項

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

2. SQL記述領域の設定内容については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

ページの先頭へ

(7)　使用例

1. PREPARE文で前処理したSQL（SQL文識別子：PRESQL）を実行します。ただし，PRESQLの?パラメタに値を与える埋込み変数（HATENA）を指定します。

   EXECUTE PRESQL USING :HATENA

2. PREPARE文で前処理したSQL（SQL文識別子：PRESQL）を実行します。ただし，PRESQLの?パラメタに値を与える情報を格納したSQL記述領域（SQLDA）を指定します。

   EXECUTE PRESQL USING DESCRIPTOR SQLDA

3. PREPARE文で前処理したSQL（SQL文識別子：PRESQL）を実行します。

   CALL PROC1（?，?，?）

   ただし，手続きPROC1の第1SQLパラメタのパラメタモードをIN，第2SQLパラメタのパラメタモードをINOUT，第3SQLパラメタのパラメタモードをOUTとします。また，第1SQLパラメタに対しては埋込み変数XPARAM1，第2SQLパラメタに対しては埋込み変数XPARAM2，第3SQLパラメタに対しては埋込み変数XPARAM3を指定します。

   EXECUTE PRESQL 
       INTO  :XPARAM2,:XPARAM3
       USING :XPARAM1,:XPARAM2

ページの先頭へ