Skip to content

Commit 3fe68b9

Browse files
authored
DRIVERS-1554 Clarify internal per-mongos clients should be used for targetedFailPoint (#1060)
1 parent 59a5dad commit 3fe68b9

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

source/unified-test-format/unified-test-format.rst

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1893,7 +1893,10 @@ test runner SHOULD use the client entity associated with the session
18931893
to execute the ``configureFailPoint`` command. In this case, the test runner
18941894
MUST also ensure that this command is excluded from the list of observed
18951895
command monitoring events for this client (if applicable). If such an API is
1896-
not available, test runners MUST create a new MongoClient that is directly
1896+
not available, but the test runner creates an internal MongoClient for each
1897+
mongos, the test runner SHOULD use the internal MongoClient corresponding to
1898+
the session's pinned server for this operation.
1899+
Otherwise, test runners MUST create a new MongoClient that is directly
18971900
connected to the session's pinned server for this operation. The new
18981901
MongoClient instance MUST be closed once the command has finished executing.
18991902

@@ -3280,8 +3283,11 @@ Change Log
32803283
:2021-08-30: Add ``hasServerConnectionId`` field to ``commandStartedEvent``,
32813284
``commandSuccededEvent`` and ``commandFailedEvent``.
32823285

3283-
:2021-08-24: Test runners may create an internal MongoClient for each mongos.
3286+
:2021-08-30: Test runners may create an internal MongoClient for each mongos.
32843287
Better clarify how internal MongoClients may be used.
3288+
Clarify that drivers creating an internal MongoClient for each
3289+
mongos should use those clients for ``targetedFailPoint``
3290+
operations.
32853291

32863292
:2021-08-23: Allow ``runOnRequirement`` conditions to be evaluated in any order.
32873293

0 commit comments

Comments
 (0)