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

SEE ALSO

43       Bulk Write Operations
44
45       mongoc_bulk_operation_t
46

ERRORS

48       Errors are propagated when executing the bulk operation.
49

RETURNS

51       A  newly  allocated  mongoc_bulk_operation_t  that should be freed with
52       mongoc_bulk_operation_destroy() when no longer in use.
53
54       WARNING:
55          Failure to handle the result  of  this  function  is  a  programming
56          error.
57

AUTHOR

59       MongoDB, Inc
60
62       2017-present, MongoDB, Inc
63
64
65
66
671.17.4                    MONGOC_FCeObLL0E4C,TI2O0N2_1CREATE_BULK_OPERATION_WITH_OPTS(3)
Impressum