mongoc_collection_create_bulk_operation_with_opts

mongoc_collection_create_bulk_operation_with_opts()

Synopsis

mongoc_bulk_operation_t *
mongoc_collection_create_bulk_operation_with_opts (
   mongoc_collection_t *collection,
   const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;

Parameters

opts may be NULL or a BSON document with additional command options:

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.

See Also

Bulk Write Operations

mongoc_bulk_operation_t

Errors

Errors are propagated when executing the bulk operation.

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.

Author

MongoDB, Inc

Info

Apr 09, 2021 1.17.5 libmongoc