EXECUTE 文 [ESQL]

EXECUTE statement
[ USING { hostvar-list | [  SQL  ] DESCRIPTOR sqlda-name } ]
[ INTO { into-hostvar-list | [ SQL ] DESCRIPTOR into-sqlda-name } ]
[ ARRAY :row-count ]

row-count : integer | hostvar

statement :   identifier | hostvar | string

sqlda-name : identifier

into-sqlda-name :  identifier

EXECUTE IMMEDIATE statement

statement :  string | hostvar

USING 句 SELECT 文または CALL 文から返される結果は、変数リストの変数の中、または指定した SQLDA が記述するプログラムデータ領域の中のいずれかに入ります。OUTPUT (select リストまたはパラメーター) 対ホスト変数リスト、または OUTPUT 対 SQLDA 記述子配列は、どちらも対応が 1 対 1 です。
INTO 句 EXECUTE INTO を INSERT 文と一緒に使用する場合、挿入されたローは 2 番目の記述子に返されます。たとえば、オートインクリメントプライマリキーを使用するとき、またはプライマリキーの値を生成する BEFORE INSERT トリガーを使用するとき、EXECUTE 文により、即座にローを再フェッチし、そのローに割り当てられているプライマリキーの値を決定するためのメカニズムが提供されます。オートインクリメントキーと一緒に @@identity を使用する場合にも同じ結果が得られます。
ARRAY 句 オプションの ARRAY 句を提供された INSERT 文と一緒に使用して、ワイド挿入ができます。ワイド挿入は複数のローを同時に挿入し、パフォーマンスを改善します。整数値は、挿入するローの数です。SQLDA には各エントリの変数 (ロー数 * カラム数) を入れます。最初のローは SQLDA の変数 0 から (ロー当たりのカラム数) -1 に入り、以後のローも同様です。

EXECUTE 文を使用して SQL 文を作成できます。データベースから多数のローを返す SELECT 文または CALL 文にはカーソルを使用します。

INSERT、UPDATE、または DELETE の実行が成功した後、SQLCA (SQLCOUNT) の sqlerrd[2] フィールドに、演算によって影響を受けるローの数が入ります。

構文 1 以前に作成された名前付きの動的文を実行します。要求についての情報を提供するホスト変数プレースホルダー (バインド変数) が動的文にある場合は、sqlda-name に C 変数を指定します。この C 変数は SQLDA へのポインターであり、SQLDA には動的文のすべてのバインド変数のための記述子を含めておきます。この方法以外に、バインド変数を hostvar-list で指定する方法もあります。
構文 2 バインド変数または出力がない文を PREPARE して EXECUTE するための省略形です。文字列またはホスト変数の中にある SQL 文を即座に実行し、完了時に削除します。

実行される文に関するパーミッションがチェックされます。

なし

SQL/2008 EXECUTE 文は、SQL/2008 標準のオプションの SQL 言語機能 B031、"Basic dynamic SQL" の一部です。INTO 句は、オプションの言語機能 B032、"Extended dynamic SQL" の一部です。ARRAY 句はベンダー拡張です。
また、Embedded SQL でサポートされている EXECUTE IMMEDIATE 文も、オプションの SQL 言語機能 B031 の一部です。

DELETE を実行します。

EXEC SQL EXECUTE IMMEDIATE
'DELETE FROM Employees WHERE EmployeeID = 105';

準備された DELETE 文を実行します。

EXEC SQL PREPARE del_stmt FROM
'DELETE FROM Employees WHERE EmployeeID = :a';
EXEC SQL EXECUTE del_stmt USING :employee_number;

準備されたクエリを実行します。

EXEC SQL PREPARE sel1 FROM
'SELECT Surname FROM Employees WHERE EmployeeID = :a';
EXEC SQL EXECUTE sel1 USING :employee_number INTO :surname;

EXECUTE 文 [ESQL]

構文 1

構文 2

パラメーター

備考

パーミッション

関連する動作

参照

標準と互換性

例