Skip to content

Commit fbff8bd

Browse files
authored
DOCSP-34090 $graphLookup limitations (#5226)
* DOCSP-34090 cannot use graphLookup in transactions targeting sharded collections * DOCSP-34090 cannot use graphLookup in transactions targeting sharded collections
1 parent 1ee8821 commit fbff8bd

File tree

5 files changed

+16
-4
lines changed

5 files changed

+16
-4
lines changed

source/core/transactions.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -409,6 +409,8 @@ Restrictions
409409

410410
- .. include:: /includes/extracts/transactions-cross-shard-collection-restriction.rst
411411

412+
- .. include:: /includes/graphLookup-sharded-coll-transaction-note.rst
413+
412414
- For explicit creation of a collection or an index inside a
413415
transaction, the transaction read concern level must be
414416
:readconcern:`"local"`. Explicit creation is through:
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
You **cannot** use the ``$graphLookup`` stage within a transaction while
2+
targeting a sharded collection.

source/reference/operator/aggregation/graphLookup.txt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,8 +163,11 @@ Considerations
163163
Sharded Collections
164164
~~~~~~~~~~~~~~~~~~~
165165

166-
Starting in MongoDB 5.1, you can specify :ref:`sharded collections <sharding-sharded-cluster>`
167-
in the ``from`` parameter of :pipeline:`$graphLookup` stages.
166+
Starting in MongoDB 5.1, you can specify :ref:`sharded collections
167+
<sharding-sharded-cluster>` in the ``from`` parameter of
168+
:pipeline:`$graphLookup` stages.
169+
170+
.. include:: /includes/graphLookup-sharded-coll-transaction-note.rst
168171

169172
Max Depth
170173
~~~~~~~~~

source/reference/operator/aggregation/lookup.txt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -501,8 +501,11 @@ Using $lookup </atlas-search/tutorial/lookup-with-search/>`.
501501
Sharded Collections
502502
~~~~~~~~~~~~~~~~~~~
503503

504-
Starting in MongoDB 5.1, you can specify :ref:`sharded collections <sharding-sharded-cluster>`
505-
in the ``from`` parameter of :pipeline:`$lookup` stages.
504+
Starting in MongoDB 5.1, you can specify :ref:`sharded collections
505+
<sharding-sharded-cluster>` in the ``from`` parameter of
506+
:pipeline:`$lookup` stages.
507+
508+
.. include:: /includes/graphLookup-sharded-coll-transaction-note.rst
506509

507510
|sbe-title|
508511
~~~~~~~~~~~

source/release-notes/6.0.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -394,6 +394,8 @@ MongoDB 6.0 introduces the following aggregation operators:
394394

395395
.. include:: /includes/5.1-fact-sharded-lookup-graphlookup.rst
396396

397+
.. include:: /includes/graphLookup-sharded-coll-transaction-note.rst
398+
397399
.. _6.0-rel-notes-change-streams:
398400

399401
Change Streams

0 commit comments

Comments
 (0)