パッケージ org.springframework.data.mongodb.core

インターフェース BulkOperations

public interface BulkOperations
コレクションに対する挿入 / 更新 / 削除アクションの一括操作。一括操作は MongoDB 2.6 以降で使用可能で、プロトコルレベルで低レベルの一括コマンドを使用します。このインターフェースは、複数の単一操作または同様の操作のリストを順番に追加するための Fluent API を定義し、最終的には execute() を呼び出すことによって実行できます。
 MongoOperations ops = …;

 ops.bulkOps(BulkMode.UNORDERED, Person.class)
                                .insert(newPerson)
                                .updateOne(where("firstname").is("Joe"), Update.update("lastname", "Doe"))
                                .execute();

一括操作は、すべての挿入、更新、削除操作をまとめた 1 つのバッチとして発行されます。楽観的ロック (@Version を使用) などの個別の操作結果を必要とする操作はサポートされておらず、バージョンフィールドは未入力のままになります。

導入:
1.9
作成者:
Tobias Trelle, Oliver Gierke, Minsu Kim

  • メソッドの詳細

    • insert

      BulkOperations insert(ObjectSE documents)
      一括操作に単一の挿入を追加します。
      パラメーター:
      documents - 挿入するドキュメントは null であってはなりません。
      戻り値:
      挿入が追加された現在の BulkOperations インスタンスは null になることはありません。

    • insert

      BulkOperations insert(ListSE<? extends ObjectSE> documents)
      一括操作に挿入のリストを追加します。
      パラメーター:
      documents - 挿入するドキュメントのリスト。null にすることはできません。
      戻り値:
      挿入が追加された現在の BulkOperations インスタンスは null になることはありません。

    • updateOne

      default BulkOperations updateOne(Query query, Update update)
      一括操作に単一の更新を追加します。更新リクエストでは、最初に一致するドキュメントのみが更新されます。
      パラメーター:
      query - 更新条件は null であってはなりません。Query は、複数の候補に一致する可能性がある場合にどのドキュメントを更新するかを制御するために sort order を定義できます。
      update - 実行する Update 操作は null であってはなりません。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • updateOne

      BulkOperations updateOne(Query query, UpdateDefinition update)
      一括操作に単一の更新を追加します。更新リクエストでは、最初に一致するドキュメントのみが更新されます。
      パラメーター:
      query - 更新条件は null であってはなりません。Query は、複数の候補に一致する可能性がある場合にどのドキュメントを更新するかを制御するために sort order を定義できます。
      update - 実行する Update 操作は null であってはなりません。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。
      導入:
      4.1

    • updateOne

      BulkOperations updateOne(ListSE<Pair<Query,UpdateDefinition>> updates)
      一括操作に更新のリストを追加します。更新リクエストごとに、最初に一致するドキュメントのみが更新されます。
      パラメーター:
      updates - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • updateMulti

      default BulkOperations updateMulti(Query query, Update update)
      一括操作に単一の更新を追加します。更新リクエストでは、一致するすべてのドキュメントが更新されます。
      パラメーター:
      query - 条件を更新します。
      update - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • updateMulti

      BulkOperations updateMulti(Query query, UpdateDefinition update)
      一括操作に単一の更新を追加します。更新リクエストでは、一致するすべてのドキュメントが更新されます。
      パラメーター:
      query - 条件を更新します。
      update - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。
      導入:
      4.1

    • updateMulti

      BulkOperations updateMulti(ListSE<Pair<Query,UpdateDefinition>> updates)
      一括操作に更新のリストを追加します。更新リクエストごとに、一致するすべてのドキュメントが更新されます。
      パラメーター:
      updates - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • upsert

      default BulkOperations upsert(Query query, Update update)
      一括操作に単一のアップサートを追加します。一致するドキュメントのセットが空でない場合はアップサートは更新であり、それ以外の場合は挿入です。
      パラメーター:
      query - 条件を更新します。
      update - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • upsert

      BulkOperations upsert(Query query, UpdateDefinition update)
      一括操作に単一のアップサートを追加します。一致するドキュメントのセットが空でない場合はアップサートは更新であり、それ以外の場合は挿入です。
      パラメーター:
      query - 条件を更新します。
      update - 実行する更新操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。
      導入:
      4.1

    • upsert

      BulkOperations upsert(ListSE<Pair<Query,Update>> updates)
      一括操作にアップサートのリストを追加します。一致するドキュメントのセットが空でない場合はアップサートが更新となり、空でない場合は挿入となります。
      パラメーター:
      updates - 実行する更新 / 挿入操作。
      戻り値:
      更新が追加された現在の BulkOperations インスタンスは null になることはありません。

    • remove

      BulkOperations remove(Query remove)
      一括操作に単一の削除操作を追加します。
      パラメーター:
      remove - 削除するドキュメントを選択するための Query は null であってはなりません。
      戻り値:
      削除が追加された現在の BulkOperations インスタンスは null になることはありません。

    • remove

      BulkOperations remove(ListSE<Query> removes)
      一括操作に削除操作のリストを追加します。
      パラメーター:
      removes - 実行する削除操作は null であってはなりません。
      戻り値:
      削除が追加された現在の BulkOperations インスタンスは null になることはありません。

    • replaceOne

      default BulkOperations replaceOne(Query query, ObjectSE replacement)
      一括操作に単一の置換操作を追加します。
      パラメーター:
      query - 置換条件。Query は、複数の候補に一致する可能性がある場合に置換するドキュメントに影響を与える sort order を定義する場合があります。
      replacement - 置換ドキュメント。null にすることはできません。
      戻り値:
      置換が追加された現在の BulkOperations インスタンスは null になることはありません。
      導入:
      2.2

    • replaceOne

      BulkOperations replaceOne(Query query, ObjectSE replacement, FindAndReplaceOptions options)
      一括操作に単一の置換操作を追加します。
      パラメーター:
      query - 置換条件。Query は、複数の候補に一致する可能性がある場合に置換するドキュメントに影響を与える sort order を定義する場合があります。
      replacement - 置換ドキュメント。null にすることはできません。
      options - 追加情報を保持する FindAndModifyOptions。null にすることはできません。
      戻り値:
      置換が追加された現在の BulkOperations インスタンスは null になることはありません。
      導入:
      2.2

    • execute

      com.mongodb.bulk.BulkWriteResult execute()
      デフォルトの書き込み条件を使用してすべての一括操作を実行します。
      戻り値:
      挿入 / 更新などのカウンターを提供する一括操作の結果。
      例外:
      BulkOperationException - 一括処理中にエラーが発生した場合。