構文およびオプショナル・パラメーター配列を指定して静的 SQL 照会を実行します。
構文
void executeSQL(String query) void executeSQL(String query, Vector queryParameters)
パラメーター
戻り値
なし。
例外
CwDBSQLException - データベース・エラーが発生した場合。
注記
executeSQL() メソッドは、指定されている照会 ストリングを静的 SQL ステートメントとして、現行接続に関係付けられているデータベースに送信します。
この照会はストリングとしてデータベースに送信されます。データベースは、このストリングを実行可能形式にコンパイルし、SQL ステートメントを実行します。この場合に、実行可能形式は保管されません。SQL ステートメントを一度のみ実行する必要がある場合は、executeSQL() を使用します。これに対して executePreparedSQL() メソッドは、実行可能形式 (準備済みステートメントと呼ばれる) を保管するため、何度も実行する必要がある照会の場合に便利です。
実行できる SQL ステートメントを以下に示します (必要なデータベース許可がある場合)。
検索したデータにアクセスするには、hasMoreRows() および nextRow() メソッドを使用します。
接続が明示的なトランザクション・ブラケットを使用している場合は、beginTransaction() を使用して各トランザクションを明示的に開始して、commit() または rollback() のいずれかを使用して終了する必要があります。
OUT パラメーターを使用してストアード・プロシージャーを実行するには、executeStoredProcedure() メソッドを使用してください。詳細については、"executeStoredProcedure() でのストアード・プロシージャーの呼び出し"を参照してください。
例
次の例では、接続が 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()