ドキュメントの変更
Overview
このガイドでは、2 つの異なる操作タイプを使用して MongoDB コレクション内のドキュメントを変更する方法を学習できます。
更新操作は、1 つ以上のドキュメント内の変更するフィールドと値を指定します。 置換操作では、フィールドと値を指定して、コレクションの 1 つのドキュメントを置き換えます。
次の例では、塗料店で 5 色の塗料を販売しています。 paint_inventoryコレクションは現在の在庫を表します。
{ "_id": 1, "color": "red", "qty": 5 } { "_id": 2, "color": "purple", "qty": 8 } { "_id": 3, "color": "yellow", "qty": 0 } { "_id": 4, "color": "green", "qty": 6 } { "_id": 5, "color": "pink", "qty": 0 }
Update
更新操作は、フィールドと値を変更する可能性があります。 アップデート ドキュメントで指定された変更を、クエリフィルターに一致する 1 つ以上のドキュメントに適用します。
updateOne() メソッドは、クエリフィルターが一致する最初のドキュメントを変更し、 updateMany() メソッドは、クエリフィルターに一致するすべてのドキュメントを変更します。
次のように、 インスタンスで updateOne()メソッドとupdateMany() メソッドを呼び出すことができます。MongoCollection
collection.updateOne(query, updateDocument); collection.updateMany(query, updateDocument);
更新操作パラメータ
updateOne()メソッドとupdateMany()メソッドにはどちらも次のパラメータがあります。
queryコレクション内の更新するドキュメントに一致する条件でクエリフィルターを指定しますupdateDocumentは、一致する 1 つまたは複数のドキュメントで変更するフィールドと値を指定します。 この例では、 アップデート ビルダを使用してアップデート ドキュメントを作成します。
次のように、 Updatesビルダを使用してupdateDocumentを作成できます。
Bson updateDocument = Updates.operator(field, value);
アップデート ビルダとその使用方法の完全なリストについては、 MongoDB API ドキュメント を参照してください。
例
塗料店で新しい商品を受け取ったので、在庫を更新する必要があります。 入荷には、各塗料塗料の20缶が含まれています。
在庫をアップデートするには、以下を指定してupdateMany()メソッドを呼び出します。
すべての色に一致するクエリフィルター
qtyフィールドを " 20ずつ増加させるための指示を含む更新ドキュメント
Bson filter = Filters.empty(); Bson update = Updates.inc("qty", 20); UpdateResult result = collection.updateMany(filter, update); System.out.println("Matched document count: " + result.getMatchedCount()); System.out.println("Modified document count: " + result.getModifiedCount());
出力は次のようになります。
Matched document count: 5 Modified document count: 5
以下は、 paint_inventoryコレクション内の更新されたドキュメントを示しています。
{ "_id": 1, "color": "red", "qty": 25 } { "_id": 2, "color": "purple", "qty": 28 } { "_id": 3, "color": "yellow", "qty": 20 } { "_id": 4, "color": "green", "qty": 26 } { "_id": 5, "color": "pink", "qty": 20 }
アップデート操作でクエリフィルターに一致するドキュメントがない場合、 updateMany()はコレクション内のドキュメントに変更を加えません。 一致するドキュメントがない場合にドキュメントを更新する代わりに新しいドキュメントを挿入する方法については、アップサート ガイドを参照してください。
置換
置換操作により、コレクションの 1 つのドキュメントが置き換えられます。 置換は、クエリフィルターが一致するドキュメントと置換ドキュメントの間で発生します。
replaceOne() メソッドは、一致するドキュメント内のすべての既存のフィールドと値（_id フィールドを除く）を削除し、それを置換ドキュメントに置き換えます。
次のように、 MongoCollectionインスタンスでreplaceOne()メソッドを呼び出すことができます。
collection.replaceOne(query, replacementDocument);
操作パラメータの置換
replaceOne() メソッドには次のパラメーターがあります。
queryコレクション内の置き換えドキュメントに一致するための条件でクエリフィルターを指定しますreplacementDocument一致したドキュメントで置き換える新しいDocumentオブジェクトのフィールドと値を指定します
例
塗料店では、在庫を再度更新する必要があることが認識されています。 ページ内を表示
在庫をアップデートするには、以下を指定してreplaceOne()メソッドを呼び出します。
colorが「pink」であるドキュメントに一致するクエリフィルターcolorが "Orange" で、qtyが " 25である置換ドキュメント
Bson filter = Filters.eq("color", "pink"); Document document = new Document("color", "orange").append("qty", 25); UpdateResult result = collection.replaceOne(filter, document); System.out.println("Matched document count: " + result.getMatchedCount()); System.out.println("Modified document count: " + result.getModifiedCount());
出力は次のようになります。
Matched document count: 1 Modified document count: 1
以下は更新されたドキュメントを示しています。
{ "_id": 5, "color": "orange", "qty": 25 }
置換操作でクエリフィルターに一致するドキュメントがない場合、 replaceOne()はコレクション内のドキュメントに変更を加えません。 一致するドキュメントがない場合に、ドキュメントを置き換える代わりに新しいドキュメントを挿入する方法については、アップサート ガイドを参照してください。
複数のドキュメントがreplaceOne()メソッドで指定されたクエリフィルターに一致する場合は、最初の結果が置き換えられます。