MONGOC_BULK_OPERATION_EXECUTE(3) | MongoDB C Driver | MONGOC_BULK_OPERATION_EXECUTE(3) |
NAME¶
mongoc_bulk_operation_execute - mongoc_bulk_operation_execute()SYNOPSIS¶
uint32_t mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk, bson_t *reply, bson_error_t *error);
This function executes all operations queued into the bulk operation. Unless ordered: false was specified in the opts passed to mongoc_collection_create_bulk_operation_with_opts(), then forward progress will be stopped upon the first error.
It is only valid to call mongoc_bulk_operation_execute() once. The mongoc_bulk_operation_t must be destroyed afterwards.
WARNING:
PARAMETERS¶
- bulk: A mongoc_bulk_operation_t.
- reply: An uninitialized bson_t.
- error: An optional location for a bson_error_t or NULL.
SEE ALSO¶
Bulk Write OperationsERRORS¶
Errors are propagated via the error parameter.RETURNS¶
On success, returns the server id used. On failure, returns 0 and sets error.A write concern timeout or write concern error is considered a failure.
The reply document counts operations and collects error information. See Bulk Write Operations for examples.
See also mongoc_bulk_operation_get_hint, which gets the id of the server used even if the operation failed.
AUTHOR¶
MongoDB, IncCOPYRIGHT¶
2017-present, MongoDB, IncFebruary 23, 2019 | 1.14.0 |