db.collection.initializeUnorderedBulkOp()
On this page
Tip
Starting in version 3.2, MongoDB also provides the
db.collection.bulkWrite()
method for performing bulk
write operations.
Definition
db.collection.initializeUnorderedBulkOp()
Important
mongo Shell Method
This page documents the
mongo
shell method, and does not refer to the MongoDB Node.js driver (or any other driver) method. For corresponding MongoDB driver API, refer to your specific MongoDB driver documentation instead.Initializes and returns a new
Bulk()
operations builder for a collection. The builder constructs an unordered list of write operations that MongoDB executes in bulk.
Behavior
Order of Operation
With an unordered operations list, MongoDB can execute in parallel
the write operations in the list and in any order. If the order of
operations matter, use
db.collection.initializeOrderedBulkOp()
instead.
Execution of Operations
When executing an unordered
list of operations,
MongoDB groups the operations. With an unordered bulk operation, the
operations in the list may be reordered to increase performance. As
such, applications should not depend on the ordering when performing
unordered
bulk
operations.
Bulk()
operations and comparable methods in the drivers do not
have a limit for the number of operations in a group. To see how the
operations are grouped for bulk operation execution, call
Bulk.getOperations()
after the execution.
Error Handling
If an error occurs during the processing of one of the write operations, MongoDB will continue to process remaining write operations in the list.
Example
The following initializes a Bulk()
operations builder and
adds a series of insert operations to add multiple documents:
var bulk = db.users.initializeUnorderedBulkOp(); bulk.insert( { user: "abc123", status: "A", points: 0 } ); bulk.insert( { user: "ijk123", status: "A", points: 0 } ); bulk.insert( { user: "mop123", status: "P", points: 0 } ); bulk.execute();