動的なSQL文の準備と実行

アプリケーション・プログラムでは、ホスト変数の中に文字ストリングを指定するという形式で、動的に SQL ステートメントを作成することができます。 一般に、ステートメントは、アプリケーション・プログラムで利用可能なデータ (例えば、ワークステーションからの入力など) から作成されます。

非Java™言語では、 PREPAREとEXECUTEを使用したSQL文の動的実行で説明されているように、構築された文は、（埋め込まれた）PREPARE文によって実行の準備をし、（埋め込まれた）EXECUTE文によって実行することができます。 この代わりに、(組み込み) ステートメント EXECUTE IMMEDIATE を使って、1 ステップ でステートメントを準備して実行することもできます。 Javaでは、Statement、 PreparedStatement,、 CallableStatement クラスを使用してステートメントを実行準備することができ、それぞれのexecute()メソッドを使用して実行することができます。

を使用します。 Db2 for z/OS® ODBC を使用すると、SQLPrepare 関数を呼び出してステートメントを準備し、SQLExecute 関数を呼び出して実行することもできます。 どちらの場合も、そのアプリケーションは組み込みの PREPARE ステートメントまたは EXECUTE ステートメントを 含みません。 SQLExecDirect 関数にステートメントを渡せば、準備なしでステートメントを実行できる。 Introduction to Db2 ODBC このインターフェイスでサポートされるAPIについて説明する。

準備するステートメントには、ホスト変数に対する参照を含めてはなりません。 パラメーター・マーカーは含めることができます。 （ パラメータマーカー に関する規則については、PREPARE文の説明を参照してください。） 準備済みのステートメントが実行される時点で、パラメーター・マーカーは、 実際には EXECUTE ステートメントで指定されたホスト変数の現行値に置き換えられます。 （この置換に関するルールについては、EXECUTE文を参照してください。） ステートメントの準備が終わった後は、ホスト変数の異なる値を使って複数回実行することができます。 パラメーター・マーカーは、EXECUTE IMMEDIATE を使用して準備し、 実行される SQL ステートメントでは使えません。

Java 以外の言語の場合、ステートメントの実行が成功したか失敗したかは 、EXECUTE (または EXECUTE IMMEDIATE) ステートメントの後で、SQLCA 内 の SQLCODE フィールドおよび SQLSTATE フィールドに戻される値により示されます。 組み込みステートメントのところで前述したように、これらの フィールドの検査が必要になります。 Javaでは、ステートメントの実行が成功したか失敗したかは、Java例外によって処理されます。