- Reference >
- mongo Shell Methods >
- Bulk Operation Methods >
- Bulk.find.replaceOne()
Bulk.find.replaceOne()¶
On this page
Description¶
- Bulk.find.replaceOne(<document>)¶
New in version 2.6.
Adds a single document replacement operation to a bulk operations list. Use the Bulk.find() method to specify the condition that determines which document to replace. The Bulk.find.replaceOne() method limits the replacement to a single document.
Bulk.find.replaceOne() accepts the following parameter:
Parameter Type Description replacement document A replacement document that completely replaces the existing document. Contains only field and value pairs.
The sum of the associated <query> document from the Bulk.find() and the replacement document must be less than or equal to the maximum BSON document size.
To specify an upsert for this operation, see Bulk.find.upsert().
Example¶
The following example initializes a Bulk() operations builder for the items collection, and adds various replaceOne operations to the list of operations.
var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { item: "abc123" } ).replaceOne( { item: "abc123", status: "P", points: 100 } );
bulk.execute();
Thank you for your feedback!
We're sorry! You can Report a Problem to help us improve this page.