Bulk.insert()¶

On this page

Description
Behavior
Example

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:

Parameter	Type	Description
`doc`	document	Document 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:

copy

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();