1MONGOC_WRITE_CONCERN_T(3)          libmongoc         MONGOC_WRITE_CONCERN_T(3)
2
3
4

NAME

6       mongoc_write_concern_t - mongoc_write_concern_t
7
8       Write Concern abstraction
9

SYNOPSIS

11       mongoc_write_concern_t  tells  the driver what level of acknowledgement
12       to await from the server. The default,  MONGOC_WRITE_CONCERN_W_DEFAULT,
13       is right for the great majority of applications.
14
15       You  can  specify  a  write concern on connection objects, database ob‐
16       jects, collection objects, or per-operation. Data-modifying  operations
17       typically  use  the  write  concern  of the object they operate on, and
18       check the server response for a write concern error  or  write  concern
19       timeout.  For  example,  mongoc_collection_drop_index  uses the collec‐
20       tion's write concern, and a write concern error or timeout in  the  re‐
21       sponse is considered a failure.
22
23       Exceptions to this principle are the generic command functions:
24
25       • mongoc_client_command
26
27       • mongoc_client_command_simple
28
29       • mongoc_database_command
30
31       • mongoc_database_command_simple
32
33       • mongoc_collection_command
34
35       • mongoc_collection_command_simple
36
37       These generic command functions do not automatically apply a write con‐
38       cern, and they do not check the server response for a write concern er‐
39       ror or write concern timeout.
40
41       See Write Concern on the MongoDB website for more information.
42

WRITE CONCERN LEVELS

44       Set the write concern level with mongoc_write_concern_set_w.
45
46              ┌───────────────────────────┬────────────────────────────┐
47              │MONGOC_WRITE_CONCERN_W_DE‐ │ By default,  writes  block │
48              │FAULT (1)                  │ awaiting   acknowledgement │
49              │                           │ from MongoDB. Acknowledged │
50              │                           │ write    concern    allows │
51              │                           │ clients to catch  network, │
52              │                           │ duplicate  key,  and other │
53              │                           │ errors.                    │
54              ├───────────────────────────┼────────────────────────────┤
55              │MONGOC_WRITE_CONCERN_W_UN‐ │ With  this  write concern, │
56              │ACKNOWLEDGED (0)           │ MongoDB does not  acknowl‐ │
57              │                           │ edge  the receipt of write │
58              │                           │ operation.  Unacknowledged │
59              │                           │ is  similar  to errors ig‐ │
60              │                           │ nored; however, mongoc at‐ │
61              │                           │ tempts to receive and han‐ │
62              │                           │ dle  network  errors  when │
63              │                           │ possible.                  │
64              └───────────────────────────┴────────────────────────────┘
65
66
67              │MONGOC_WRITE_CONCERN_W_MA‐ │ Block until  a  write  has │
68              │JORITY (majority)          │ been  propagated  to a ma‐ │
69              │                           │ jority of the nodes in the │
70              │                           │ replica set.               │
71              ├───────────────────────────┼────────────────────────────┤
72              │n                          │ Block  until  a  write has │
73              │                           │ been  propagated   to   at │
74              │                           │ least   n   nodes  in  the │
75              │                           │ replica set.               │
76              └───────────────────────────┴────────────────────────────┘
77

DEPRECATIONS

79       The write concern MONGOC_WRITE_CONCERN_W_ERRORS_IGNORED (value -1) is a
80       deprecated synonym for MONGOC_WRITE_CONCERN_W_UNACKNOWLEDGED (value 0),
81       and will be removed in the next major release.
82
83       mongoc_write_concern_set_fsync is deprecated.
84

AUTHOR

86       MongoDB, Inc
87

89       2017-present, MongoDB, Inc
90
91
92
93
941.20.0                           Nov 18, 2021        MONGOC_WRITE_CONCERN_T(3)
Impressum