- Reference >
mongo
Shell Methods >- Bulk Operation Methods >
- Bulk.insert()
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: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.