Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2025-05-25 12:27
📄 README.rst ===================================== Convenient API for Transactions Tests ===================================== .. contents:: ---- Introduction ============ The YAML and JSON files in this directory are platform-independent tests that drivers can use to prove their conformance to the Convenient API for Transactions spec. They are designed with the intention of sharing some test-runner code with the CRUD, Command Monitoring, and Transaction spec tests. Several prose tests, which are not easily expressed in YAML, are also presented in this file. Those tests will need to be manually implemented by each driver. Server Fail Point ================= See: `Server Fail Point <../../transactions/tests#server-fail-point>`_ in the Transactions spec test suite. Test Format =========== Each YAML file has the following keys: - ``runOn`` (optional): An array of server version and/or topology requirements for which the tests can be run. If the test environment satisfies one or more of these requirements, the tests may be executed; otherwise, this file should be skipped. If this field is omitted, the tests can be assumed to have no particular requirements and should be executed. Each element will have some or all of the following fields: - ``minServerVersion`` (optional): The minimum server version (inclusive) required to successfully run the tests. If this field is omitted, it should be assumed that there is no lower bound on the required server version. - ``maxServerVersion`` (optional): The maximum server version (inclusive) against which the tests can be run successfully. If this field is omitted, it should be assumed that there is no upper bound on the required server version. - ``topology`` (optional): An array of server topologies against which the tests can be run successfully. Valid topologies are "single", "replicaset", and "sharded". If this field is omitted, the default is all topologies (i.e. ``["single", "replicaset", "sharded"]``). - ``database_name`` and ``collection_name``: The database and collection to use for testing. - ``data``: The data that should exist in the collection under test before each test run. - ``tests``: An array of tests that are to be run independently of each other. Each test will have some or all of the following fields: - ``description``: The name of the test. - ``skipReason`` (optional): If present, the test should be skipped and the string value will specify a reason. - ``failPoint`` (optional): The ``configureFailPoint`` command document to run to configure a fail point on the primary server. This option and ``useMultipleMongoses: true`` are mutually exclusive. - ``useMultipleMongoses`` (optional): If ``true``, the MongoClient for this test should be initialized with multiple mongos seed addresses. If ``false`` or omitted, only a single mongos address should be specified. This field has no effect for non-sharded topologies. - ``clientOptions`` (optional): Names and values of options to pass to ``MongoClient()``. - ``sessionOptions`` (optional): Names and values of options to pass to ``MongoClient.startSession()``. - ``operations``: Array of documents, each describing an operation to be executed. Each document has the following fields: - ``name``: The name of the operation on ``object``. - ``object``: The name of the object on which to perform the operation. The value will be either "collection" or "session0". - ``arguments`` (optional): Names and values of arguments to pass to the operation. - ``result`` (optional): The return value from the operation. This will correspond to an operation's result object as defined in the CRUD specification. If the operation is expected to return an error, the ``result`` is a single document that has one or more of the following fields: - ``errorContains``: A substring of the expected error message. - ``errorCodeName``: The expected "codeName" field in the server error response. - ``errorLabelsContain``: A list of error label strings that the error is expected to have. - ``errorLabelsOmit``: A list of error label strings that the error is expected not to have. - ``expectations`` (optional): List of command-started events. - ``outcome``: Document describing the return value and/or expected state of the collection after the operation is executed. Contains the following fields: - ``collection``: - ``data``: The data that should exist in the collection after the operations have run. ``withTransaction`` Operation ````````````````````````````` These tests introduce a ``withTransaction`` operation, which may have the following fields: - ``callback``: Document containing the following field: - ``operations``: Array of documents, each describing an operation to be executed. Elements in this array will follow the same structure as the ``operations`` field defined above (and in the CRUD and Transactions specs). Note that drivers are expected to evaluate ``error`` and ``result`` assertions when executing operations within ``callback.operations``. - ``options`` (optional): Names and values of options to pass to ``withTransaction()``, which will in turn be used for ``startTransaction()``. Use as Integration Tests ======================== Testing against a replica set will require server version 4.0.0 or later. The replica set should include a primary, a secondary, and an arbiter. Including a secondary ensures that server selection in a transaction works properly. Including an arbiter helps ensure that no new bugs have been introduced related to arbiters. Testing against a sharded cluster will require server version 4.1.6 or later. A driver that implements support for sharded transactions MUST also run these tests against a MongoDB sharded cluster with multiple mongoses. Including multiple mongoses (and initializing the MongoClient with multiple mongos seeds!) ensures that mongos transaction pinning works properly. See: `Use as Integration Tests <../../transactions/tests#use-as-integration-tests>`_ in the Transactions spec test suite for instructions on executing each test. Take note of the following: - Most tests will consist of a single "withTransaction" operation to be invoked on the "session0" object. The ``callback`` argument of that operation will resemble the ``operations`` array found in transaction spec tests. Command-Started Events `````````````````````` See: `Command-Started Events <../../transactions/tests#command-started-events>`_ in the Transactions spec test suite for instructions on asserting command-started events. Prose Tests =========== Callback Raises a Custom Error `````````````````````````````` Write a callback that raises a custom exception or error that does not include either UnknownTransactionCommitResult or TransientTransactionError error labels. Execute this callback using ``withTransaction`` and assert that the callback's error bypasses any retry logic within ``withTransaction`` and is propagated to the caller of ``withTransaction``. Callback Returns a Value ```````````````````````` Write a callback that returns a custom value (e.g. boolean, string, object). Execute this callback using ``withTransaction`` and assert that the callback's return value is propagated to the caller of ``withTransaction``. Retry Timeout is Enforced ````````````````````````` Drivers should test that ``withTransaction`` enforces a non-configurable timeout before retrying both commits and entire transactions. Specifically, three cases should be checked: * If the callback raises an error with the TransientTransactionError label and the retry timeout has been exceeded, ``withTransaction`` should propagate the error to its caller. * If committing raises an error with the UnknownTransactionCommitResult label, the error is not a write concern timeout, and the retry timeout has been exceeded, ``withTransaction`` should propagate the error to its caller. * If committing raises an error with the TransientTransactionError label and the retry timeout has been exceeded, ``withTransaction`` should propagate the error to its caller. This case may occur if the commit was internally retried against a new primary after a failover and the second primary returned a NoSuchTransaction error response. If possible, drivers should implement these tests without requiring the test runner to block for the full duration of the retry timeout. This might be done by internally modifying the timeout value used by ``withTransaction`` with some private API or using a mock timer. Changelog ========= :2019-03-01: Add top-level ``runOn`` field to denote server version and/or topology requirements requirements for the test file. Removes the ``minServerVersion`` top-level field, which is now expressed within ``runOn`` elements. Add test-level ``useMultipleMongoses`` field.	8.94 KB	2025-05-25 12:27
📄 callback-aborts.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "withTransaction succeeds if callback aborts", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "abortTransaction", "object": "session0" } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "abortTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "abortTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [] } } }, { "description": "withTransaction succeeds if callback aborts with no ops", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "abortTransaction", "object": "session0" } ] } } } ], "expectations": [], "outcome": { "collection": { "data": [] } } }, { "description": "withTransaction still succeeds if callback aborts and runs extra op", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "abortTransaction", "object": "session0" }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 2 } }, "result": { "insertedId": 2 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "abortTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "abortTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 2 } ], "ordered": true, "lsid": "session0", "autocommit": null, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } } ], "outcome": { "collection": { "data": [ { "_id": 2 } ] } } } ] }	6.01 KB	2025-05-25 12:27
📄 callback-aborts.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - # Session state will be ABORTED when callback returns to withTransaction description: withTransaction succeeds if callback aborts useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: abortTransaction object: session0 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: abortTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: abortTransaction database_name: admin outcome: collection: data: [] - # Session state will be ABORTED when callback returns to withTransaction description: withTransaction succeeds if callback aborts with no ops useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: abortTransaction object: session0 expectations: [] outcome: collection: data: [] - # Session state will be NO_TXN when callback returns to withTransaction description: withTransaction still succeeds if callback aborts and runs extra op useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: abortTransaction object: session0 - name: insertOne object: collection arguments: session: session0 document: { _id: 2 } result: insertedId: 2 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: abortTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: abortTransaction database_name: admin - command_started_event: command: # This test is agnostic about retryWrites, so we do not assert the # txnNumber. If retryWrites=true, the txnNumber will be incremented # from the value used in the previous transaction; otherwise, the # field will not be present at all. insert: collection_name documents: - { _id: 2 } ordered: true lsid: session0 # omitted fields autocommit: ~ readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name outcome: collection: data: - { _id: 2 }	4.71 KB	2025-05-25 12:27
📄 callback-commits.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "withTransaction succeeds if callback commits", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 2 } }, "result": { "insertedId": 2 } }, { "name": "commitTransaction", "object": "session0" } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 2 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 }, { "_id": 2 } ] } } }, { "description": "withTransaction still succeeds if callback commits and runs extra op", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 2 } }, "result": { "insertedId": 2 } }, { "name": "commitTransaction", "object": "session0" }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 3 } }, "result": { "insertedId": 3 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 2 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 3 } ], "ordered": true, "lsid": "session0", "autocommit": null, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } } ], "outcome": { "collection": { "data": [ { "_id": 1 }, { "_id": 2 }, { "_id": 3 } ] } } } ] }	7.64 KB	2025-05-25 12:27
📄 callback-commits.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - # Session state will be COMMITTED when callback returns to withTransaction description: withTransaction succeeds if callback commits useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: insertOne object: collection arguments: session: session0 document: { _id: 2 } result: insertedId: 2 - name: commitTransaction object: session0 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: insert: collection_name documents: - { _id: 2 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - { _id: 2 } - # Session state will be NO_TXN when callback returns to withTransaction description: withTransaction still succeeds if callback commits and runs extra op useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: insertOne object: collection arguments: session: session0 document: { _id: 2 } result: insertedId: 2 - name: commitTransaction object: session0 - name: insertOne object: collection arguments: session: session0 document: { _id: 3 } result: insertedId: 3 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: insert: collection_name documents: - { _id: 2 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: # This test is agnostic about retryWrites, so we do not assert the # txnNumber. If retryWrites=true, the txnNumber will be incremented # from the value used in the previous transaction; otherwise, the # field will not be present at all. insert: collection_name documents: - { _id: 3 } ordered: true lsid: session0 # omitted fields autocommit: ~ readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name outcome: collection: data: - { _id: 1 } - { _id: 2 } - { _id: 3 }	5.7 KB	2025-05-25 12:27
📄 callback-retry.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "callback succeeds after multiple connection errors", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "insert" ], "closeConnection": true } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "abortTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "abortTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "abortTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "abortTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "callback is not retried after non-transient error (DuplicateKeyError)", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "errorLabelsOmit": [ "TransientTransactionError", "UnknownTransactionCommitResult" ] } } ] } }, "result": { "errorLabelsOmit": [ "TransientTransactionError", "UnknownTransactionCommitResult" ], "errorContains": "E11000" } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "abortTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "abortTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [] } } } ] }	8.03 KB	2025-05-25 12:27
📄 callback-retry.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - description: callback succeeds after multiple connection errors failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["insert"] closeConnection: true operations: - name: withTransaction object: session0 arguments: callback: operations: - # We do not assert the result here, as insertOne will fail for # the first two executions of the callback before ultimately # succeeding and returning a result. Asserting the state of the # output collection after the test is sufficient. name: insertOne object: collection arguments: session: session0 document: { _id: 1 } expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: abortTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: abortTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # second transaction will be causally consistent with the first readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "2" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: abortTransaction: 1 lsid: session0 txnNumber: { $numberLong: "2" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: abortTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # third transaction will be causally consistent with the second readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "3" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "3" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - description: callback is not retried after non-transient error (DuplicateKeyError) useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: errorLabelsOmit: ["TransientTransactionError", "UnknownTransactionCommitResult"] result: errorLabelsOmit: ["TransientTransactionError", "UnknownTransactionCommitResult"] # DuplicateKey error code included in the bulk write error message # returned by the server errorContains: E11000 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: abortTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: abortTransaction database_name: admin outcome: collection: data: []	6.34 KB	2025-05-25 12:27
📄 commit-retry.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "commitTransaction succeeds after multiple connection errors", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "closeConnection": true } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commitTransaction retry only overwrites write concern w option", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "closeConnection": true } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] }, "options": { "writeConcern": { "w": 2, "j": true, "wtimeout": 5000 } } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 2, "j": true, "wtimeout": 5000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "j": true, "wtimeout": 5000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "j": true, "wtimeout": 5000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commit is retried after commitTransaction UnknownTransactionCommitResult (NotWritablePrimary)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 10107, "errorLabels": [ "RetryableWriteError" ], "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commit is not retried after MaxTimeMSExpired error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 1 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 50 } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] }, "options": { "maxCommitTimeMS": 60000 } }, "result": { "errorCodeName": "MaxTimeMSExpired", "errorLabelsContain": [ "UnknownTransactionCommitResult" ], "errorLabelsOmit": [ "TransientTransactionError" ] } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "maxTimeMS": 60000, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [] } } } ] }	13.36 KB	2025-05-25 12:27
📄 commit-retry.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - description: commitTransaction succeeds after multiple connection errors failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] closeConnection: true operations: - &withTransaction name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - description: commitTransaction retry only overwrites write concern w option failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] closeConnection: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 options: writeConcern: { w: 2, j: true, wtimeout: 5000 } expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 2, j: true, wtimeout: 5000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, j: true, wtimeout: 5000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, j: true, wtimeout: 5000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - description: commit is retried after commitTransaction UnknownTransactionCommitResult (NotWritablePrimary) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 10107 # NotWritablePrimary errorLabels: ["RetryableWriteError"] # SPEC-1565 closeConnection: false operations: - withTransaction expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - description: commit is not retried after MaxTimeMSExpired error failPoint: configureFailPoint: failCommand mode: { times: 1 } data: failCommands: ["commitTransaction"] errorCode: 50 # MaxTimeMSExpired operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 options: maxCommitTimeMS: 60000 result: errorCodeName: MaxTimeMSExpired errorLabelsContain: ["UnknownTransactionCommitResult"] errorLabelsOmit: ["TransientTransactionError"] expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: *database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false maxTimeMS: 60000 # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: # In reality, the outcome of the commit is unknown but we fabricate # the error with failCommand.errorCode which does not apply the commit # operation. data: []	9.55 KB	2025-05-25 12:27
📄 commit-transienttransactionerror-4.2.json { "runOn": [ { "minServerVersion": "4.1.6", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "transaction is retried after commitTransaction TransientTransactionError (PreparedTransactionInProgress)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 267, "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } } ] }	4.92 KB	2025-05-25 12:27
📄 commit-transienttransactionerror-4.2.yml runOn: - minServerVersion: "4.1.6" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] # These tests use error codes where the TransientTransactionError label will be # applied to the error response for commitTransaction. This will cause the # entire transaction to be retried instead of commitTransaction. # # See: https://github.com/mongodb/mongo/blob/r4.1.6/src/mongo/db/handle_request_response.cpp tests: - description: transaction is retried after commitTransaction TransientTransactionError (PreparedTransactionInProgress) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 267 # PreparedTransactionInProgress closeConnection: false operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # second transaction will be causally consistent with the first readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "2" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "2" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # third transaction will be causally consistent with the second readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "3" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "3" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 }	4.17 KB	2025-05-25 12:27
📄 commit-transienttransactionerror.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "transaction is retried after commitTransaction TransientTransactionError (LockTimeout)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 24, "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "transaction is retried after commitTransaction TransientTransactionError (WriteConflict)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 112, "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "transaction is retried after commitTransaction TransientTransactionError (SnapshotUnavailable)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 246, "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "transaction is retried after commitTransaction TransientTransactionError (NoSuchTransaction)", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "errorCode": 251, "closeConnection": false } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "3" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "3" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } } ] }	18.7 KB	2025-05-25 12:27
📄 commit-transienttransactionerror.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] # These tests use error codes where the TransientTransactionError label will be # applied to the error response for commitTransaction. This will cause the # entire transaction to be retried instead of commitTransaction. # # See: https://github.com/mongodb/mongo/blob/r4.1.6/src/mongo/db/handle_request_response.cpp tests: - description: transaction is retried after commitTransaction TransientTransactionError (LockTimeout) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 24 # LockTimeout closeConnection: false operations: &operations - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 expectations: &expectations - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # second transaction will be causally consistent with the first readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "2" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "2" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 # third transaction will be causally consistent with the second readConcern: { afterClusterTime: 42 } # txnNumber is incremented when retrying the transaction txnNumber: { $numberLong: "3" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "3" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: &outcome collection: data: - { _id: 1 } - description: transaction is retried after commitTransaction TransientTransactionError (WriteConflict) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 112 # WriteConflict closeConnection: false operations: operations expectations: expectations outcome: outcome - description: transaction is retried after commitTransaction TransientTransactionError (SnapshotUnavailable) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 246 # SnapshotUnavailable closeConnection: false operations: operations expectations: expectations outcome: outcome - description: transaction is retried after commitTransaction TransientTransactionError (NoSuchTransaction) failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] errorCode: 251 # NoSuchTransaction closeConnection: false operations: operations expectations: expectations outcome: *outcome	5.36 KB	2025-05-25 12:27
📄 commit-writeconcernerror.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "commitTransaction is retried after WriteConcernFailed timeout error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "writeConcernError": { "code": 64, "codeName": "WriteConcernFailed", "errmsg": "waiting for replication timed out", "errInfo": { "wtimeout": true } } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commitTransaction is retried after WriteConcernFailed non-timeout error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 2 }, "data": { "failCommands": [ "commitTransaction" ], "writeConcernError": { "code": 64, "codeName": "WriteConcernFailed", "errmsg": "multiple errors reported" } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": "majority", "wtimeout": 10000 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commitTransaction is not retried after UnknownReplWriteConcern error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 1 }, "data": { "failCommands": [ "commitTransaction" ], "writeConcernError": { "code": 79, "codeName": "UnknownReplWriteConcern", "errmsg": "No write concern mode named 'foo' found in replica set configuration" } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } }, "result": { "errorCodeName": "UnknownReplWriteConcern", "errorLabelsOmit": [ "TransientTransactionError", "UnknownTransactionCommitResult" ] } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commitTransaction is not retried after UnsatisfiableWriteConcern error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 1 }, "data": { "failCommands": [ "commitTransaction" ], "writeConcernError": { "code": 100, "codeName": "UnsatisfiableWriteConcern", "errmsg": "Not enough data-bearing nodes" } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } }, "result": { "errorCodeName": "UnsatisfiableWriteConcern", "errorLabelsOmit": [ "TransientTransactionError", "UnknownTransactionCommitResult" ] } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "commitTransaction is not retried after MaxTimeMSExpired error", "failPoint": { "configureFailPoint": "failCommand", "mode": { "times": 1 }, "data": { "failCommands": [ "commitTransaction" ], "writeConcernError": { "code": 50, "codeName": "MaxTimeMSExpired", "errmsg": "operation exceeded time limit" } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } }, "result": { "errorCodeName": "MaxTimeMSExpired", "errorLabelsContain": [ "UnknownTransactionCommitResult" ], "errorLabelsOmit": [ "TransientTransactionError" ] } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } } ] }	15.26 KB	2025-05-25 12:27
📄 commit-writeconcernerror.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - description: commitTransaction is retried after WriteConcernFailed timeout error failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] # Do not specify closeConnection: false, since that would conflict # with writeConcernError (see: SERVER-39292) writeConcernError: code: 64 codeName: WriteConcernFailed errmsg: "waiting for replication timed out" errInfo: { wtimeout: true } operations: - &operation name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 expectations: &expectations_with_retries - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # commitTransaction applies w:majority on retries (SPEC-1185) writeConcern: { w: majority, wtimeout: 10000 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin # The write operation is still applied despite the write concern error outcome: &outcome collection: data: - { _id: 1 } - # This test configures the fail point to return an error with the # WriteConcernFailed code but without errInfo that would identify it as a # wtimeout error. This tests that drivers do not assume that all # WriteConcernFailed errors are due to a replication timeout. description: commitTransaction is retried after WriteConcernFailed non-timeout error failPoint: configureFailPoint: failCommand mode: { times: 2 } data: failCommands: ["commitTransaction"] # Do not specify closeConnection: false, since that would conflict # with writeConcernError (see: SERVER-39292) writeConcernError: code: 64 codeName: WriteConcernFailed errmsg: "multiple errors reported" operations: - operation expectations: expectations_with_retries outcome: outcome - description: commitTransaction is not retried after UnknownReplWriteConcern error failPoint: configureFailPoint: failCommand mode: { times: 1 } data: failCommands: ["commitTransaction"] writeConcernError: code: 79 codeName: UnknownReplWriteConcern errmsg: "No write concern mode named 'foo' found in replica set configuration" operations: - <<: operation result: errorCodeName: UnknownReplWriteConcern errorLabelsOmit: ["TransientTransactionError", "UnknownTransactionCommitResult"] expectations: &expectations_without_retries - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin # failCommand with writeConcernError still applies the write operation(s) outcome: outcome - description: commitTransaction is not retried after UnsatisfiableWriteConcern error failPoint: configureFailPoint: failCommand mode: { times: 1 } data: failCommands: ["commitTransaction"] writeConcernError: code: 100 codeName: UnsatisfiableWriteConcern errmsg: "Not enough data-bearing nodes" operations: - <<: operation result: errorCodeName: UnsatisfiableWriteConcern errorLabelsOmit: ["TransientTransactionError", "UnknownTransactionCommitResult"] expectations: expectations_without_retries # failCommand with writeConcernError still applies the write operation(s) outcome: outcome - description: commitTransaction is not retried after MaxTimeMSExpired error failPoint: configureFailPoint: failCommand mode: { times: 1 } data: failCommands: ["commitTransaction"] writeConcernError: code: 50 codeName: MaxTimeMSExpired errmsg: "operation exceeded time limit" operations: - <<: operation result: errorCodeName: MaxTimeMSExpired errorLabelsContain: ["UnknownTransactionCommitResult"] errorLabelsOmit: ["TransientTransactionError"] expectations: expectations_without_retries # failCommand with writeConcernError still applies the write operation(s) outcome: *outcome	6.98 KB	2025-05-25 12:27
📄 commit.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "withTransaction commits after callback returns", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 2 } }, "result": { "insertedId": 2 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 2 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 }, { "_id": 2 } ] } } }, { "description": "withTransaction commits after callback returns (second transaction)", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } }, { "name": "commitTransaction", "object": "session0" }, { "name": "startTransaction", "object": "session0" }, { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 2 } }, "result": { "insertedId": 2 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } }, { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 2 } ], "ordered": true, "lsid": "session0", "readConcern": { "afterClusterTime": 42 }, "txnNumber": { "$numberLong": "2" }, "startTransaction": true, "autocommit": false, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "2" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 }, { "_id": 2 } ] } } } ] }	7.2 KB	2025-05-25 12:27
📄 commit.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - description: withTransaction commits after callback returns useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: insertOne object: collection arguments: session: session0 document: { _id: 2 } result: insertedId: 2 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: insert: collection_name documents: - { _id: 2 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - { _id: 2 } - # In this scenario, the callback commits the transaction originally started # by withTransaction and starts a second transaction before returning. Since # withTransaction only examines the session's state, it should commit that # second transaction after the callback returns. description: withTransaction commits after callback returns (second transaction) useMultipleMongoses: true operations: - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 - name: commitTransaction object: session0 - name: startTransaction object: session0 - name: insertOne object: collection arguments: session: session0 document: { _id: 2 } result: insertedId: 2 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin - command_started_event: command: insert: collection_name documents: - { _id: 2 } ordered: true lsid: session0 # second transaction will be causally consistent with the first readConcern: { afterClusterTime: 42 } # txnNumber is incremented for the second transaction txnNumber: { $numberLong: "2" } startTransaction: true autocommit: false # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "2" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: collection: data: - { _id: 1 } - { _id: 2 }	5.44 KB	2025-05-25 12:27
📄 transaction-options.json { "runOn": [ { "minServerVersion": "4.0", "topology": [ "replicaset" ] }, { "minServerVersion": "4.1.8", "topology": [ "sharded" ] } ], "database_name": "withTransaction-tests", "collection_name": "test", "data": [], "tests": [ { "description": "withTransaction and no transaction options set", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": null, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "readConcern": null, "startTransaction": null, "writeConcern": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "withTransaction inherits transaction options from client", "useMultipleMongoses": true, "clientOptions": { "readConcernLevel": "local", "w": 1 }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": { "level": "local" }, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 1 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "withTransaction inherits transaction options from defaultTransactionOptions", "useMultipleMongoses": true, "sessionOptions": { "session0": { "defaultTransactionOptions": { "readConcern": { "level": "majority" }, "writeConcern": { "w": 1 } } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": { "level": "majority" }, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 1 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "withTransaction explicit transaction options", "useMultipleMongoses": true, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] }, "options": { "readConcern": { "level": "majority" }, "writeConcern": { "w": 1 } } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": { "level": "majority" }, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 1 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "withTransaction explicit transaction options override defaultTransactionOptions", "useMultipleMongoses": true, "sessionOptions": { "session0": { "defaultTransactionOptions": { "readConcern": { "level": "snapshot" }, "writeConcern": { "w": "majority" } } } }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] }, "options": { "readConcern": { "level": "majority" }, "writeConcern": { "w": 1 } } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": { "level": "majority" }, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 1 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } }, { "description": "withTransaction explicit transaction options override client options", "useMultipleMongoses": true, "clientOptions": { "readConcernLevel": "local", "w": "majority" }, "operations": [ { "name": "withTransaction", "object": "session0", "arguments": { "callback": { "operations": [ { "name": "insertOne", "object": "collection", "arguments": { "session": "session0", "document": { "_id": 1 } }, "result": { "insertedId": 1 } } ] }, "options": { "readConcern": { "level": "majority" }, "writeConcern": { "w": 1 } } } } ], "expectations": [ { "command_started_event": { "command": { "insert": "test", "documents": [ { "_id": 1 } ], "ordered": true, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "startTransaction": true, "autocommit": false, "readConcern": { "level": "majority" }, "writeConcern": null }, "command_name": "insert", "database_name": "withTransaction-tests" } }, { "command_started_event": { "command": { "commitTransaction": 1, "lsid": "session0", "txnNumber": { "$numberLong": "1" }, "autocommit": false, "writeConcern": { "w": 1 }, "readConcern": null, "startTransaction": null }, "command_name": "commitTransaction", "database_name": "admin" } } ], "outcome": { "collection": { "data": [ { "_id": 1 } ] } } } ] }	14.1 KB	2025-05-25 12:27
📄 transaction-options.yml runOn: - minServerVersion: "4.0" topology: ["replicaset"] - minServerVersion: "4.1.8" topology: ["sharded"] database_name: &database_name "withTransaction-tests" collection_name: &collection_name "test" data: [] tests: - description: withTransaction and no transaction options set useMultipleMongoses: true operations: &operations - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false # omitted fields readConcern: ~ writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false # omitted fields readConcern: ~ startTransaction: ~ writeConcern: ~ command_name: commitTransaction database_name: admin outcome: &outcome collection: data: - { _id: 1 } - description: withTransaction inherits transaction options from client useMultipleMongoses: true clientOptions: readConcernLevel: local w: 1 operations: operations expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false readConcern: { level: local } # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 1 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: outcome - description: withTransaction inherits transaction options from defaultTransactionOptions useMultipleMongoses: true sessionOptions: session0: defaultTransactionOptions: readConcern: { level: majority } writeConcern: { w: 1 } operations: operations expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false readConcern: { level: majority } # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 1 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: outcome - description: withTransaction explicit transaction options useMultipleMongoses: true operations: &operations_explicit_transactionOptions - name: withTransaction object: session0 arguments: callback: operations: - name: insertOne object: collection arguments: session: session0 document: { _id: 1 } result: insertedId: 1 options: readConcern: { level: majority } writeConcern: { w: 1 } expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false readConcern: { level: majority } # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 1 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: outcome - description: withTransaction explicit transaction options override defaultTransactionOptions useMultipleMongoses: true sessionOptions: session0: defaultTransactionOptions: readConcern: { level: snapshot } writeConcern: { w: majority } operations: operations_explicit_transactionOptions expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false readConcern: { level: majority } # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 1 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: outcome - description: withTransaction explicit transaction options override client options useMultipleMongoses: true clientOptions: readConcernLevel: local w: majority operations: operations_explicit_transactionOptions expectations: - command_started_event: command: insert: collection_name documents: - { _id: 1 } ordered: true lsid: session0 txnNumber: { $numberLong: "1" } startTransaction: true autocommit: false readConcern: { level: majority } # omitted fields writeConcern: ~ command_name: insert database_name: database_name - command_started_event: command: commitTransaction: 1 lsid: session0 txnNumber: { $numberLong: "1" } autocommit: false writeConcern: { w: 1 } # omitted fields readConcern: ~ startTransaction: ~ command_name: commitTransaction database_name: admin outcome: *outcome	7.74 KB	2025-05-25 12:27

Edit File:

Terminal