executePreparedSQL()

構文およびオプショナル・パラメーター配列を指定して準備済み SQL 照会を実行します。

構文

void executePreparedSQL(String query)
 void executePreparedSQL(String query, Vector queryParameters)
 

パラメーター

query
データベースで実行する SQL 照会のストリング表現。

queryParameters
SQL 照会でパラメーターに渡される引き数の Vector オブジェクト。

戻り値

なし。

例外

CwDBSQLException - データベース・エラーが発生した場合。

注記

executePreparedSQL() メソッドは、指定されている照会 ストリングを準備済み SQL ステートメントとして、現行接続に関連付けられているデータベースに送信します。

この照会は、最初に実行されるときにストリングとしてデータベースに送信されます。データベースは、このストリングを実行可能形式 (準備済みステートメントと呼ばれる) にコンパイルし、SQL ステートメントを実行し、この準備済みステートメントを executePreparedSQL() に戻します。executePreparedSQL() メソッドは、準備済みステートメントをメモリー内に保管します。SQL ステートメントを複数回実行する必要がある場合は、executePreparedSQL() を使用します。これに対して executeSQL() メソッドは、準備済みステートメントを保管しない ため、一度のみ実行すればよい照会の場合に便利です。

要確認:
executePreparedSQL() を使用して照会を実行する前に、getDBConnection() メソッドを使用して BaseDLM クラスから CwDBConnection を生成し、目的のデータベースへの接続を取得しておく必要があります。

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

関連項目

"準備済み照会の実行"

beginTransaction()commit()executeSQL()executeStoredProcedure()getDBConnection()hasMoreRows()nextRow()rollBack()

Copyright IBM Corp. 2004