17.5.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ドライバでは，次の場合に逐次実行します。

• パラメタとSQL文のaddBatchの混在時でのバッチ更新

• HiRDBのBINARY型に対する？パラメタを含むSQL文でのバッチ更新（BINARY型の？パラメタに設定するデータの長さが32,001バイト以上の場合）

• HiRDBのBLOB型に対する？パラメタを含むSQL文でのバッチ更新

＜注意事項＞

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

注意事項：

結果セット(ResultSet)を返すストアドプロシジャは，バッチ更新ではストアドプロシジャを実行するまで結果セットを返すかどうか分からないため，ストアドプロシジャ内で更新をしている場合，更新が反映されることがあるので注意してください。例えば，更新後にその結果を検索し取得するストアドプロシジャを，バッチ更新で実行すると，BatchUpdateExceptionが発生するが，更新は反映されてしまうことがあります。

ページの先頭へ

(4)　注意事項

PreparedStatement pstmt = con.prepareStatement("UPDATE T1 SET C1=? WHERE C2=?");
pstmt.setInt(1, 1);
pstmt.setInt(2, 1);
pstmt.addBatch();
pstmt.setInt(1, 2);
pstmt.setInt(2, 2);
pstmt.addBatch();
pstmt.addBatch("INSERT INTO T2 VALUES(1,2,3)");
pstmt.setInt(1, 3);
pstmt.setInt(2, 4);
pstmt.addBatch();
pstmt.setInt(1, 4);
pstmt.setInt(2, 4);
pstmt.addBatch();
pstmt.executeBatch();

PreparedStatement pstmt = con.prepareStatement("UPDATE T1 SET C1=? WHERE C2=?");
pstmt.setInt(1, 1);
pstmt.setInt(2, 1);
pstmt.executeUpdate();
pstmt.setInt(1, 2);
pstmt.setInt(2, 2);
pstmt.executeUpdate();
pstmt.executeUpdate("INSERT INTO T2 VALUES(1,2,3)");
pstmt.setInt(1, 3);
pstmt.setInt(2, 4);
pstmt.executeUpdate();
pstmt.setInt(1, 4);
pstmt.setInt(2, 4);
pstmt.executeUpdate();

PreparedStatement pstmt = con.prepareStatement("INSERT INTO T1 VALUES(?,?)");
pstmt.setInt(1, 1);
pstmt.setString(2,"aaaa");
pstmt.addBatch();
pstmt.setInt(1, 2);
pstmt.setString(2,"bbbbbbbb");
pstmt.addBatch();.......................................[A]
pstmt.setInt(1, 3);
pstmt.setString(2,"cccc");
pstmt.addBatch();
pstmt.executeBatch();

Statement stmt = con.createStatement();
stmt.addBatch("INSERT INTO T1 VALUES(1,'aaaa')");
stmt.addBatch("INSERT INTO T1 VALUES(2,'bbbbbbbb')");...[A]
stmt.addBatch("INSERT INTO T1 VALUES(3,'cccc')");
stmt.executeBatch();

ページの先頭へ