executeSQL()

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

構文

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

パラメーター

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

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

戻り値

なし。

例外

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

注記

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

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

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

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

次の例では、接続が AccntConnPool 接続プール内にあるアカウンティング・データベースに、行を挿入する照会を実行します。

CwDBConnection connection = getDBConnection("AccntConnPool");
  
 // Begin a transaction
 connection.beginTransaction();
  
 // Insert a row
 connection.executeSQL("insert...");
  
 // Commit the transaction
 connection.commit();
  
 // Release the database connection
 connection.release();
 

データベース表からデータを選択する、より完全なコード・サンプルは、"データを戻す静的照会の実行 (SELECT)"を参照してください。

関連項目

"静的照会の実行"

executePreparedSQL()executeStoredProcedure()getDBConnection()hasMoreRows()nextRow()

Copyright IBM Corp. 2004