Skip to content

Commit ba1958b

Browse files
ravindk89kay-kim
authored andcommitted
DOCS-11447: Improve docs on linearizable read concern
1 parent 9384084 commit ba1958b

File tree

2 files changed

+17
-12
lines changed

2 files changed

+17
-12
lines changed

source/includes/extracts-concurrency-consistency-recency.yaml

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -134,10 +134,12 @@ content: |
134134
---
135135
ref: no-journaling-rollback
136136
content: |
137+
137138
With :rsconf:`writeConcernMajorityJournalDefault` set to ``false``,
138-
MongoDB will not wait for
139-
:writeconcern:`w: "majority" <"majority">` writes to be durable
140-
before acknowledging the writes. As such, :writeconcern:`"majority"`
141-
write operations could possibly
142-
roll back in the event of a loss of a replica set member.
139+
MongoDB does not wait for :writeconcern:`w: "majority" <"majority">`
140+
writes to be written to the on-disk journal before acknowledging the
141+
writes. As such, :writeconcern:`majority` write operations could
142+
possibly roll back in the event of a transient loss (e.g. crash and
143+
restart) of a majority of nodes in a given replica set.
144+
143145
...

source/reference/read-concern.txt

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -94,13 +94,16 @@ The following read concern levels are available:
9494

9595
* - .. readconcern:: "linearizable"
9696

97-
- The query returns data that reflects all successful writes
98-
issued with a write concern of :writeconcern:`"majority"` *and*
99-
acknowledged prior to the start of the read operation. For
100-
replica sets that run with
101-
:rsconf:`writeConcernMajorityJournalDefault` set to true,
102-
linearizable read concern returns data that will never be rolled
103-
back.
97+
- The query returns data that reflects all successful
98+
majority-acknowledged writes that completed prior to the start
99+
of the read operation. The query may wait for concurrently
100+
executing writes to propagate to a majority of replica
101+
set members before returning results.
102+
103+
If a majority of your replica set members crash and restart after
104+
the read operation, documents returned by the read operation are
105+
durable if :rsconf:`writeConcernMajorityJournalDefault` is set to
106+
the default state of ``true``.
104107

105108
.. include:: /includes/extracts/no-journaling-rollback.rst
106109

0 commit comments

Comments
 (0)