- Reference >
mongo
Shell Methods >- Bulk Operation Methods >
- Bulk.find.updateOne()
Bulk.find.updateOne()¶
On this page
Description¶
-
Bulk.find.
updateOne
(<update>)¶ New in version 2.6.
Adds a single document update operation to a bulk operations list. The operation can either replace an existing document or update specific fields in an existing document.
Use the
Bulk.find()
method to specify the condition that determines which document to update. TheBulk.find.updateOne()
method limits the update or replacement to a single document. To update multiple documents, seeBulk.find.update()
.Bulk.find.updateOne()
accepts the following parameter:Parameter Type Description update
document An update document that updates specific fields or a replacement document that completely replaces the existing document.
An update document only contains update operator expressions. A replacement document contains only field and value pairs.
The sum of the associated
<query>
document from theBulk.find()
and the update/replacement document must be less than or equal to themaximum BSON document size
.To specify an upsert: true for this operation, see
Bulk.find.upsert()
.
Behavior¶
Update Specific Fields¶
If the <update>
document contains only update operator expressions, as in:
Then, Bulk.find.updateOne()
updates only the corresponding
fields, status
and points
, in the document.
Replace a Document¶
If the <update>
document contains only field:value
expressions, as in:
Then, Bulk.find.updateOne()
replaces the matching document
with the <update>
document with the exception of the _id
field.
The Bulk.find.updateOne()
method does not replace the
_id
value.