Deprecated since version 1.9.0: Use mongoc_collection_create_bulk_operation_with_opts() instead.
Contents
Copyright
2009-present, MongoDB, Inc.
1.30.4 Jun 08, 2025 MONGOC_COLLECTION_CREATE_BULK_OPERATION(3)
Description
This function shall begin a new bulk operation. After creating this you may call various functions such
as mongoc_bulk_operation_update(), mongoc_bulk_operation_insert() and others.
After calling mongoc_bulk_operation_execute() the commands will be executed in as large as batches as
reasonable by the client.
If ordered is true, then processing will stop at the first error.
If ordered is not true, then the bulk operation will attempt to continue processing even after the first
failure.
write_concern contains the write concern for all operations in the bulk operation. If NULL, the
collection's write concern is used. The global default is acknowledged writes:
MONGOC_WRITE_CONCERN_W_DEFAULT.
Errors
Errors are propagated when executing the bulk operation.
Parameters
• collection: A mongoc_collection_t.
• ordered: If the operations must be performed in order.
• write_concern: An optional mongoc_write_concern_t or NULL.
Returns
A newly allocated mongoc_bulk_operation_t that should be freed with mongoc_bulk_operation_destroy() when
no longer in use.
WARNING:
Failure to handle the result of this function is a programming error.
SEEALSO:BulkWriteOperationsmongoc_bulk_operation_tSynopsis
mongoc_bulk_operation_t *
mongoc_collection_create_bulk_operation (
mongoc_collection_t *collection,
bool ordered,
const mongoc_write_concern_t *write_concern);
Warning:
Deprecated since version 1.9.0: Use mongoc_collection_create_bulk_operation_with_opts() instead.
