16.3.2　バッチ更新

(1)　Statementクラスでのバッチ更新

Statementクラスでのバッチ更新の留意点を次に示します。

• 複数の更新系SQLを，addBatchメソッドで登録します。

• 登録した更新系SQLを，executeBatchメソッドで一括して実行します。

• 一括実行の結果として，それぞれの更新系SQLで更新された行数の配列を返却します。

• 一括実行の途中でエラーが発生した場合，BatchUpdateExceptionを投入します。

• 登録したSQL中に検索系SQLがある場合，executeBatchメソッド呼び出し時にBatchUpdateExceptionを投入します。

なお，JDBCドライバでは，複数のSQLを一括実行できないため，登録されたSQLを逐次実行することになります。

ページの先頭へ

(2)　PreparedStatementクラスでのバッチ更新

PreparedStatementクラスでのバッチ更新の留意点を次に示します。

• PreparedStatementインスタンス生成時に指定した更新系SQLに対する？パラメタを，通常の手順（setXXXメソッド）で設定します。

• addBatchメソッドで？パラメタのセットを登録します。

• 登録した複数セットの？パラメタを，executeBatchメソッドで一括して実行します。

• 一括実行の結果として，それぞれの？パラメタのセットで更新した行数の配列を返却します。

• 一括実行の途中でエラーが発生した場合，BatchUpdateExceptionを投入します。

• PreparedStatementインスタンス生成時に指定したSQLが検索系SQLの場合，executeBatchメソッド呼び出し時にBatchUpdateExceptionを投入します。

JDBCドライバでは，配列を使用した機能を利用した場合，複数行の？パラメタの一括実行ができます。配列を使用した機能を利用しない場合は，複数行の？パラメタを逐次実行することになります。

注意事項：

• HiRDBの配列を使用した機能を利用する場合，「バッチ更新」の注意事項を参照してください。

• 2件目以降のaddBatchで，setXXXメソッドで指定するパラメタ数が不足していた場合，前回セットした値が引き継がれるため注意が必要です。例を次に示します。

例：INTEGER型列が2列(列1，列2)ある場合

prepstmt.setInt(1,100);
prepstmt.setInt(2,100);
prepstmt.addBatch();
prepstmt.setInt(1,200);
prepstmt.addBatch();
prepstmt.executeBatch();

［説明］

• 1件目のaddBatchで設定される値は，列1＝100，列2＝100となります。

  1件目のaddBatchでパラメタ数が不足している場合は，エラーが発生します。

• 2件目のaddBatchで設定される値は，列1＝200，列2＝100となります。

  2件目のaddBatchで，列2の情報が更新されていないため，1件目のaddBatchの情報が引き継がれます。

ページの先頭へ

(3)　CallableStatementクラスでのバッチ更新

CallableStatementクラスでのバッチ更新の留意点を次に示します。

• CallableStatementインスタンス生成時に指定したJavaストアドルーチンに対する入力パラメタを，通常の手順（setXXXメソッド）で設定します。

• addBatchメソッドで入力パラメタのセットを登録します。

• 登録した複数セットの入力パラメタを，executeBatchメソッドで一括して実行します。

• 一括実行の結果として，それぞれの入力パラメタのセットで実行したJavaストアドルーチンの返却値（更新行数）の配列を返却します。

• 一括実行の途中でエラーが発生した場合，BatchUpdateExceptionを投入します。

• CallableStatementインスタンス生成時に指定したJavaストアドルーチンが，更新行数を返却するルーチンでない場合，executeBatchメソッド呼び出し時にBatchUpdateExceptionを投入します。

• CallableStatementインスタンス生成時に指定したJavaストアドルーチンが，出力パラメタ及び入出力パラメタを持つ場合，addBatchメソッド呼び出し時にBatchUpdateExceptionを投入します。

なお，JDBCドライバでは，複数行のストアドプロシジャの？パラメタを一括実行できないため，複数行のストアドプロシジャの？パラメタを逐次実行することになります。

注意事項：

• ストアドプロシジャのバッチ更新は，INパラメタでだけ使用できます。OUTパラメタ，INOUTパラメタ，及び結果セット(ResultSet)を持つ場合はエラーとなります。

• 結果セット(ResultSet)を返すストアドプロシジャは，バッチ更新ではストアドプロシジャを実行するまで結果セットを返すかどうか分からないため，ストアドプロシジャ内で更新をしている場合，更新が反映されることがあるので注意してください。^※１

• 配列を使用した機能は，ストアドプロシジャでは利用できません。?パラメタを持つSQLでだけ使用できます。

• 2件目以降のaddBatchで，setXXXメソッドで指定するパラメタ数が不足している場合，前回セットした値が引き継がれるため注意が必要です。^※２

• 配列を使用した機能を利用する場合，「バッチ更新」の配列を使用した機能を利用する場合の注意事項を参照してください。

注※1

例えば，更新後にその結果を検索し取得するストアドプロシジャを，バッチ更新で実行すると，BatchUpdateExceptionが発生するが，更新は反映されてしまうことがあります。

注※2

INTEGER型列が2列(列1，列2)ある場合の例を次に示します。

callstmt.setInt(1,100);
callstmt.setInt(2,100);
callstmt.addBatch();
callstmt.setInt(1,200);
callstmt.addBatch();
callstmt.executeBatch();

［説明］

• 1件目のaddBatchで設定される値は，列1＝100，列2＝100となります。

  1件目のaddBatchでパラメタ数が不足している場合は，エラーが発生します。

• 2件目のaddBatchで設定される値は，列1＝200，列2＝100となります。

  2件目のaddBatchで列2の情報が更新されていないため，1件目のaddBatchの情報が引き継がれます。

ページの先頭へ