Docs Home → Develop Applications → MongoDB Manual
Bulk.insert()
On this page
Tip
Starting in version 3.2, MongoDB also provides the
db.collection.bulkWrite() method for performing bulk
write operations.
Description
Bulk.insert(<document>)Adds an insert operation to a bulk operations list.
Bulk.insert()accepts the following parameter:ParameterTypeDescriptiondocdocumentDocument to insert. The size of the document must be less than or equal to the maximum BSON document size.
Behavior
Insert Inaccuracies
Even if you encounter a server error during an insert, some documents may have been inserted.
After a successful insert, the system returns BulkWriteResult.nInserted, the number
of documents inserted into the collection. If the insert
operation is interrupted by a replica set state change,
the system may continue inserting documents. As a result,
BulkWriteResult.nInserted may report fewer documents than actually inserted.
Example
The following initializes a Bulk() operations builder for the
items collection and adds a series of insert operations to add
multiple documents:
var bulk = db.items.initializeUnorderedBulkOp(); bulk.insert( { item: "abc123", defaultQty: 100, status: "A", points: 100 } ); bulk.insert( { item: "ijk123", defaultQty: 200, status: "A", points: 200 } ); bulk.insert( { item: "mop123", defaultQty: 0, status: "P", points: 0 } ); bulk.execute();