4.21.1　EXECUTE IMMEDIATE文の形式と規則

(1)　機能

文字列で与えられたSQLを，前処理して実行します。

ページの先頭へ

(2)　使用権限

なし。

ページの先頭へ

(3)　形式

　EXECUTE IMMEDIATE｛’文字列‘｜：埋込み変数｝
　〔｛INTO ：埋込み変数〔：標識変数〕
　　　　　　　〔，：埋込み変数〔：標識変数〕〕…
　　　｜INTO DESCRIPTOR 〔：〕SQL記述領域名
                       〔CHARACTER_SET〔：〕文字集合名記述領域名〕｝〕
　〔｛USING ：埋込み変数〔：標識変数〕
　　　　　　　　〔，：埋込み変数〔：標識変数〕〕…
　　　｜USING DESCRIPTOR 〔：〕SQL記述領域名
                       〔CHARACTER_SET〔：〕文字集合名記述領域名〕｝〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

1. 実行するSQL文字列中に，SQL先頭子，及びSQL終了子は指定できません。

2. 実行するSQLの最大長は，2,000,000バイトです。ただし，SQLの文字列を文字定数で指定した場合は，UAP記述言語の文字定数の最大長です。

3. 埋込み変数の型は，次に示す構造体です。

     struct {
           long  xxxxxxx;      /* SQL文の有効長   */
           char  yyyyyyy[n];   /* SQL文格納エリア */
     } zzzzzzz;

   （凡例）

   xxxxxxxは，文字配列yyyyyyy中に格納した文字列の有効長を示します。

   1 ≦ （xxxxxxxの値） ≦ 2000000

   なお，文字列の有効長に文字列の終わりを示す‘￥0’は含みません。

   nは，任意です。

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

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

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

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

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

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

ページの先頭へ

(6)　留意事項

1. EXECUTE IMMEDIATE文は，次に示すSQLを実行する場合と同じです。文字列で指定したSQLを繰り返して実行する場合は，一度PREPARE文で前処理して，EXECUTE文で繰り返し実行することをお勧めします。

   • PREPARE SQL文識別子FROM｛’文字列‘｜：埋込み変数｝

   • EXECUTE SQL文識別子

   EXECUTE IMMEDIATE文で前処理・実行できるSQLを次に示します。

   • 操作系SQL

     ASSIGN LIST文，CALL文，DELETE文，準備可能動的DELETE文：位置付け，DROP LIST文，INSERT文，PURGE TABLE文，1行SELECT文，UPDATE文，準備可能動的UPDATE文：位置付け

   • 制御系SQL

     LOCK TABLE文

   • 定義系SQL

     ALTER INDEX，ALTER PROCEDURE，ALTER ROUTINE，ALTER TABLE，ALTER TRIGGER，COMMENT，CREATE AUDIT，CREATE CONNECTION SECURITY，CREATE FUNCTION，CREATE INDEX，CREATE PROCEDURE，CREATE SCHEMA，CREATE SEQUENCE，CREATE TABLE，CREATE TRIGGER，CREATE TYPE，CREATE VIEW，DROP AUDIT，DROP CONNECTION SECURITY，DROP DATA TYPE，DROP FUNCTION，DROP INDEX，DROP PROCEDURE，DROP SCHEMA，DROP SEQUENCE，DROP TABLE，DROP TRIGGER，DROP VIEW，GRANT，REVOKE

ページの先頭へ

(7)　使用例

1. 文字列として与えたSQL’PURGE TABLE ZAIKO’を前処理して実行します。

   EXECUTE IMMEDIATE ‘PURGE TABLE ZAIKO’

2. 埋込み変数（：ZAIX）として定義したSQLを前処理して実行します。

   EXECUTE IMMEDIATE :ZAIX

3. 文字列として与えたSQL’SELECT SNAME FROM ZAIKO WHERE SCODE = ?’を前処理して実行し，検索結果を埋込み変数（:XSNAME），標識変数(:ISNAME)に読み込みます。このとき，?パラメタに与える値の情報を格納した埋込み変数（:XSCODE），標識変数(:ISCODE)を指定します。

   EXECUTE IMMEDIATE ’SELECT SNAME FROM ZAIKO WHERE SCODE = ?’ 
         INTO :XSNAME:ISNAME
         USING :XSCODE:ISCODE

ページの先頭へ