Skip to content

Commit 96d6615

Browse files
(DOCS-15807): Add details for oplog hole (#4110)
* (DOCS-15807): Add details for oplog hole * fix include file name * minimalism * change w:1 formatting
1 parent 501660d commit 96d6615

File tree

4 files changed

+17
-1
lines changed

4 files changed

+17
-1
lines changed

source/core/replica-set-rollbacks.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,8 @@ If the operation to roll back is a collection drop or a document
144144
deletion, the rollback of the collection drop or document deletion
145145
is not written to the rollback data directory.
146146

147+
.. include:: /includes/w-1-rollback-warning.rst
148+
147149
Read Rollback Data
148150
~~~~~~~~~~~~~~~~~~
149151

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
.. warning::
2+
3+
In MongoDB 4.4 and later, if write operations use
4+
:writeconcern:`{ w: 1 } <\<number\>>` write concern, the rollback
5+
directory may exclude writes submitted after an :term:`oplog hole`
6+
if the primary restarts before the write operation completes.

source/reference/glossary.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -724,6 +724,13 @@ Glossary
724724
basic mechanism enabling :term:`replication` in MongoDB.
725725
See :doc:`/core/replica-set-oplog`.
726726

727+
oplog hole
728+
A temporary gap in the oplog due to oplog writes not occurring in
729+
sequence. Replica set :ref:`primaries <replica-set-primary>` apply
730+
oplog entries in parallel as a batch operation. As a result,
731+
temporary gaps in the oplog can occur from entries that are not
732+
yet written from a batch.
733+
727734
oplog window
728735
.. include:: /includes/replication/fact-oplog-window-definition.rst
729736

source/reference/write-concern.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,8 @@ available:
128128
if the primary steps down before the write operations have
129129
replicated to any of the secondaries.
130130

131+
.. include:: /includes/w-1-rollback-warning.rst
132+
131133
``w: 0``
132134
Requests no acknowledgment of the write operation. However, ``w:
133135
0`` may return information about socket exceptions and
@@ -498,4 +500,3 @@ Write Concern Contrasted with Commit Quorum
498500
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
499501

500502
.. include:: /includes/indexes/commit-quorum-vs-write-concern.rst
501-

0 commit comments

Comments
 (0)