1MONGOC_COLLECTION_CREATE_BUMLOKN_GOOPCE_RCAOTlLIiLObENmC_oTWnIIgOToNHc__CORPETAST(E3_)BULK_OPERATION_WITH_OPTS(3)
2
3
4

NAME

6       mongoc_collection_create_bulk_operation_with_opts    -   mongoc_collec‐
7       tion_create_bulk_operation_with_opts()
8

SYNOPSIS

10          mongoc_bulk_operation_t *
11          mongoc_collection_create_bulk_operation_with_opts (
12             mongoc_collection_t *collection,
13             const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
14

PARAMETERS

16       • collection: A mongoc_collection_t.
17
18       opts may be NULL or a BSON document with additional command options:
19
20       • writeConcern:  Construct  a  mongoc_write_concern_t  and   use   mon‐
21         goc_write_concern_append  to  add  the write concern to opts. See the
22         example code for mongoc_client_write_command_with_opts.
23
24       • ordered: set to false to attempt to insert all documents,  continuing
25         after errors.
26
27       • sessionId:  First,  construct  a  mongoc_client_session_t  with  mon‐
28         goc_client_start_session. You  can  begin  a  transaction  with  mon‐
29         goc_client_session_start_transaction, optionally with a mongoc_trans‐
30         action_opt_t that overrides the options  inherited  from  collection,
31         and  use mongoc_client_session_append to add the session to opts. See
32         the example code for mongoc_client_session_t.
33

DESCRIPTION

35       This function shall begin a new bulk operation. After creating this you
36       may call various functions such as mongoc_bulk_operation_update(), mon‐
37       goc_bulk_operation_insert() and others.
38
39       After calling mongoc_bulk_operation_execute() the commands will be exe‐
40       cuted in as large as batches as reasonable by the client.
41

ERRORS

43       Errors are propagated when executing the bulk operation.
44

RETURNS

46       A  newly  allocated  mongoc_bulk_operation_t  that should be freed with
47       mongoc_bulk_operation_destroy() when no longer in use.
48
49       WARNING:
50          Failure to handle the result of this function is a  programming  er‐
51          ror.
52
53       SEE ALSO:
54          Bulk Write Operations
55
56          mongoc_bulk_operation_t
57
58

AUTHOR

60       MongoDB, Inc
61

63       2017-present, MongoDB, Inc
64
65
66
67
681.21.1                    MONGOC_MCaOrLL0E2C,TI2O0N2_2CREATE_BULK_OPERATION_WITH_OPTS(3)
Impressum