Bulk.find.update()
On this page
Tip
Starting in version 3.2, MongoDB also provides the
db.collection.bulkWrite() method for performing bulk
write operations.
Description
Bulk.find.update(<update>)Adds a
multiupdate operation to a bulk operations list. The method updates specific fields in existing documents.Use the
Bulk.find()method to specify the condition that determines which documents to update. TheBulk.find.update()method updates all matching documents. To specify a single document update, seeBulk.find.updateOne().Bulk.find.update()accepts the following parameter:ParameterTypeDescriptiondocument or pipelineThe modifications to apply. Can be one of the following:
Update documentContains only update operator expressions.Aggregation pipeline
Starting in MongoDB 4.2Contains only the following aggregation stages:
$addFieldsand its alias$set$replaceRootand its alias$replaceWith.
For more information on the update modification parameter, see the
db.collection.updateMany()reference page.The sum of the associated
<query>document from theBulk.find()and the update document must be less than or equal to the maximum BSON document size.To specify an upsert: true for this operation, use with
Bulk.find.upsert(). WithBulk.find.upsert(), if no documents match theBulk.find()query condition, the update operation inserts only a single document.To specify
arrayFiltersto update specific array elements, use withBulk.find.arrayFilters().To specify the index to use for the associated
Bulk.find(), seeBulk.find.hint().To replace a document wholesale, see
Bulk.find.replaceOne().
Example
The following example initializes a Bulk() operations builder
for the items collection, and adds various multi update
operations to the list of operations.
var bulk = db.items.initializeUnorderedBulkOp(); bulk.find( { status: "D" } ).update( { $set: { status: "I", points: "0" } } ); bulk.find( { item: null } ).update( { $set: { item: "TBD" } } ); bulk.execute();
Update with Aggregation Pipeline
Starting in version 4.2, update methods can accept an aggregation pipeline. For example, the following uses:
the
$setstage which can provide similar behavior to the$setupdate operator expression,the aggregation variable
NOW, which resolves to the current datetime and can provide similar behavior to a$currentDateupdate operator expression. To access aggregation variables, prefix the variable with double dollar signs$$and enclose in quotes.
var bulk = db.items.initializeUnorderedBulkOp(); bulk.find( { status: "P" } ).update( [ { $set: { points: 0, lastModified: "$$NOW" } } ] ); bulk.execute();