1MONGOC_BULK_OPERATION_EXECUTE(3)   libmongoc  MONGOC_BULK_OPERATION_EXECUTE(3)
2
3
4

SYNOPSIS

6          uint32_t
7          mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,
8                                         bson_t *reply,
9                                         bson_error_t *error);
10
11       This  function  executes all operations queued into the bulk operation.
12       Unless  ordered:  false  was  specified   in   the   opts   passed   to
13       mongoc_collection_create_bulk_operation_with_opts(),    then    forward
14       progress will be stopped upon the first error.
15
16       It is only valid to call mongoc_bulk_operation_execute() once. The mon‐
17       goc_bulk_operation_t must be destroyed afterwards.
18
19       WARNING:
20          reply  is  always  initialized, even upon failure. Callers must call
21          bson_destroy() to release this potential allocation.
22

PARAMETERS

24       • bulk: A mongoc_bulk_operation_t.
25
26       • reply: An uninitialized bson_t.
27
28       • error: An optional location for a bson_error_t or NULL.
29

ERRORS

31       Errors are propagated via the error parameter.
32

RETURNS

34       On success, returns the server id used. On failure, returns 0 and  sets
35       error.
36
37       A write concern timeout or write concern error is considered a failure.
38
39       The  reply  document  counts operations and collects error information.
40       See Bulk Write Operations for examples.
41
42       SEE ALSO:
43          Bulk Write Operations
44
45          mongoc_bulk_operation_get_hint(), which gets the id of the server used even if the operation failed.
46
47

AUTHOR

49       MongoDB, Inc
50

52       2017-present, MongoDB, Inc
53
54
55
56
571.25.1                           Nov 08, 2023 MONGOC_BULK_OPERATION_EXECUTE(3)
Impressum