Execute SQL

構文を指定して静的 SQL 照会を実行します。

入力

Database connection
データベース接続を表す CwDBConnection オブジェクト。

Query
データベースで実行する SQL 照会を表す String。

例外

Execute SQL 機能ブロックは、データベース・エラーが発生した場合に CwDBSQLException 例外をスローできます。

Execute SQL 機能ブロックは、静的 SQL ステートメントとして、指定された照会 ストリングを現行接続に関連付けられているデータベースに送信します。

この照会はストリングとしてデータベースに送信されます。データベースは、このストリングを実行可能形式にコンパイルし、SQL ステートメントを実行します。この場合に、実行可能形式は保管されません。1 回だけ実行する必要のある SQL ステートメントには、Execute SQL を使用してください。

注:
Execute Prepared SQL 機能ブロックと Execute Prepared SQL with Parameter 機能ブロックは、実行可能形式 (準備済みステートメントと呼ばれる) を保管するので、何度も実行する必要がある照会の場合に便利です。
要確認

Execute SQL を使用して照会を実行する前に、Get Database Connection 機能ブロックを使用して CwDBConnection オブジェクトを生成することにより、目的のデータベースへの接続を確立する必要があります。

実行できる SQL ステートメントを以下に示します (必要なデータベース許可がある場合)。

関連情報

この機能ブロックは、CwDBConnection.executeSQL() メソッドを基にしています。詳細については、executeSQL()を参照してください。

Copyright IBM Corp. 2004