Skip to content

DOCS-13775 Ban snapshot reads on capped colls #4917

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 11, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion source/core/capped-collections.txt
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,11 @@ field by default.
Restrictions and Recommendations
--------------------------------

Reads
~~~~~

.. include:: /includes/extracts/transactions-capped-collection-read-change.rst

Updates
~~~~~~~

Expand Down Expand Up @@ -131,7 +136,7 @@ Transactions
~~~~~~~~~~~~

.. include:: /includes/extracts/transactions-capped-collection-change.rst

Procedures
----------

Expand Down
16 changes: 13 additions & 3 deletions source/includes/extracts-transactions.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,10 @@ content: |
- You cannot write to :doc:`capped </core/capped-collections>`
collections. (Starting in MongoDB 4.2)

- You cannot use read concern :readconcern:`"snapshot"` when reading
from a :doc:`capped </core/capped-collections>` collection.
(Starting in MongoDB 5.0)

- You cannot read/write to collections in the ``config``, ``admin``,
or ``local`` databases.

Expand Down Expand Up @@ -437,9 +441,15 @@ content: |

Starting in MongoDB 4.2, you cannot write to :doc:`capped
</core/capped-collections>` collections in :doc:`transactions
</core/transactions>`. Reads from :doc:`capped
</core/capped-collections>` collections are still supported
in :doc:`transactions </core/transactions>`.
</core/transactions>`.

---
ref: transactions-capped-collection-read-change
content: |

Starting in MongoDB 5.0, you cannot use read concern
:readconcern:`"snapshot"` when reading from a
:doc:`capped </core/capped-collections>` collection.

---
ref: transactions-arbiters
Expand Down
7 changes: 7 additions & 0 deletions source/reference/read-concern-snapshot.txt
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,13 @@ Operations
For a list of all operations that accept read concerns, see
:ref:`read-concern-operations`.

Read Concern on Capped Collections
----------------------------------

Starting in version 5.0, you cannot use read concern
:readconcern:`"snapshot"` when reading from a
:doc:`capped </core/capped-collections>` collection.

Read Concern and Transactions
-----------------------------

Expand Down
7 changes: 6 additions & 1 deletion source/release-notes/4.2-compatibility.txt
Original file line number Diff line number Diff line change
Expand Up @@ -360,7 +360,12 @@ Transactions

- .. include:: /includes/extracts/transactions-killop-change.rst

- .. include:: /includes/extracts/transactions-capped-collection-change.rst
- Starting in MongoDB 4.2, you cannot write to
:doc:`capped </core/capped-collections>` collections in
:doc:`transactions </core/transactions>`. Reads from
:doc:`capped </core/capped-collections>`
collections are still supported in
:doc:`transactions </core/transactions>`.

- Starting in MongoDB 4.2, MongoDB removes the 16MB total size
limit for a transaction. In version 4.2, MongoDB creates as many
Expand Down
5 changes: 5 additions & 0 deletions source/release-notes/5.0-compatibility.txt
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,11 @@ Projection Compatibility Changes
Map Reduce Changes
------------------

Read Concern `Snapshot` on Capped Collections
---------------------------------------------

.. include:: /includes/extracts/transactions-capped-collection-read-change.rst

General Changes
---------------

Expand Down