Skip to content

Commit 52e8f65

Browse files
authored
DOCSP-25224 eol cleanup v4.2 (#2148)
* DOCSP-25224 EOL Version Cleanup of mongosh Methods (#1901) (#2146) (#2147) * DOCSP-25224 EOL Version Cleanup of mongosh Methods (#1901) * Fixes build error * Fixes build errors * Fixes build errors * Fixes build errors * Fixes build errors * Build error
1 parent 33205e7 commit 52e8f65

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

56 files changed

+191
-848
lines changed

source/faq/concurrency.txt

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -385,10 +385,6 @@ than one database:
385385
* - Operation
386386
-
387387

388-
* - :method:`db.copyDatabase()`
389-
- This operation obtains a global (W) exclusive lock and blocks
390-
other operations until it finishes.
391-
392388
* - | :dbcommand:`reIndex`
393389
| :method:`db.collection.reIndex()`
394390
- .. versionchanged:: 4.2
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
2+
.. note::
3+
4+
You cannot use ``resumeAfter`` to resume a change stream after an
5+
:ref:`invalidate event <change-event-invalidate>` (for example, a collection
6+
drop or rename) closes the stream. Starting in MongoDB 4.2, you can use
7+
:ref:`startAfter <change-stream-start-after>` to start a new change
8+
stream after an :ref:`invalidate event <change-event-invalidate>`.
9+

source/includes/cursor-index-use.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
2+
.. note:: Index Use
3+
4+
To use an index with the :method:`~cursor.max()` method, you must use the
5+
:method:`~cursor.hint()` method to specify the index you want to use,
6+
exept when the :method:`~db.collection.find()` query is an equality
7+
condition on the ``_id`` field.
8+

source/includes/extracts-listCollections-auth.yaml

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ content: |
1414
The built-in role :authrole:`read` provides the privilege to run
1515
:dbcommand:`listCollection` for a specific database.
1616
17-
Starting in version 4.0, however, user without the required privilege
17+
Users without the required privilege
1818
can run the command with **both** ``authorizedCollections`` and
1919
``nameOnly`` options set to ``true``. In this case, the command returns
2020
just the name and type of the collection(s) to which the user has
@@ -48,8 +48,7 @@ content: |
4848
ref: listCollections-auth-show-collections
4949
content: |
5050
51-
Starting in version 4.0 of the :binary:`~bin.mongo` shell, ``show
52-
collections`` is equivalent to:
51+
The ``mongo`` shell, ``show collections`` is equivalent to:
5352
5453
.. code-block:: javascript
5554
@@ -79,8 +78,7 @@ content: |
7978
ref: listCollections-auth-showCollectionNames
8079
content: |
8180
82-
Starting in version 4.0 of the :binary:`~bin.mongo` shell,
83-
:method:`db.getCollectionNames()` is equivalent to:
81+
The :method:`db.getCollectionNames()` is equivalent to:
8482
8583
.. code-block:: javascript
8684

source/includes/extracts-sessions.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -110,8 +110,8 @@ content: |
110110
ref: sessions-cursor-timeout
111111
content: |
112112
113-
Starting in MongoDB 3.6, MongoDB drivers and the :binary:`~bin.mongo`
114-
shell associate all operations with a :doc:`server session
113+
MongoDB drivers and :binary:`~bin.mongosh`
114+
associate all operations with a :doc:`server session
115115
</reference/server-sessions>`, with the exception of unacknowledged
116116
write operations. For operations not explicitly associated with a
117117
session (i.e. using :method:`Mongo.startSession()`), MongoDB drivers

source/includes/extracts-syncFrom.yaml

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,9 @@ content: |
33
Sync Logic
44
~~~~~~~~~~
55
6-
.. versionchanged:: 3.4
7-
86
If an initial sync operation is in progress when you run
97
{{syncfrom}}, {{syncfrom}} stops the in-progress initial sync and
10-
restarts the sync process with the new target. In previous versions,
11-
if you run {{syncfrom}} during initial sync, MongoDB produces no
12-
error messages, but the sync target will not change until after the
13-
initial sync operation.
8+
restarts the sync process with the new target.
149
1510
Only modify the default sync logic as needed, and always exercise
1611
caution.

source/includes/extracts-zoned-sharding.yaml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,8 +66,7 @@ content: |
6666
ref: zoned-sharding-drop-collection-change
6767
content: |
6868
69-
Starting in MongoDB 4.0.2, dropping a collection deletes its
70-
associated zone/tag ranges.
69+
Dropping a collection deletes its associated zone/tag ranges.
7170
7271
...
7372

source/includes/fact-aggregate-readConcern.rst

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,3 @@ Starting in MongoDB 4.2, you can specify :doc:`read concern
22
</reference/read-concern>` level :readconcern:`"majority"` for an
33
aggregation that includes an :pipeline:`$out` stage.
44

5-
In MongoDB 4.0 and earlier, you cannot include the :pipeline:`$out`
6-
stage to use :readconcern:`"majority"` read concern for the aggregation.
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
2+
MongoDB uses an optimized build process that obtains and holds an exclusive
3+
lock on the specified collection at the start and end of the index build. All
4+
subsequent operations on the collection must wait until |method| releases
5+
the exclusive lock. |method| allows interleaving read and write
6+
operations during the majority of the index build.
7+
8+
For more information on the locking behavior of |method|, see
9+
:ref:`index-operations`.
10+
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
Your application connection logic should include tolerance for automatic
2-
failovers and the subsequent elections. Starting in MongoDB 3.6, MongoDB drivers
2+
failovers and the subsequent elections. MongoDB drivers
33
can detect the loss of the primary and automatically
44
:ref:`retry certain write operations <retryable-writes>` a single time,
55
providing additional built-in handling of automatic failovers and elections:
66

7-
- MongoDB 4.2+ compatible drivers enable retryable writes by default
7+
.. versionchanged:: 4.2
8+
9+
Starting in MongoDB 4.2, compatible drivers enable retryable writes by default
810

9-
- MongoDB 4.0 and 3.6-compatible drivers must explicitly enable
10-
retryable writes by including :urioption:`retryWrites=true <retryWrites>` in the :ref:`connection string <mongodb-uri>`.

0 commit comments

Comments
 (0)