abortTransaction

On this page

Definition

Syntax
Behavior

Definition

abortTransaction

New in version 4.0.

Terminates the multi-document transaction and rolls back any data changes made by the operations within the transaction. That is, the transaction ends without saving any of the changes made by the operations in the transaction.

To run the abortTransaction, the command must be run against the admin database and run within a Session(). Rather than run the abortTransaction command directly, most users should use the driver method or the mongosh Session.abortTransaction() helper.

Syntax

The command has the following syntax:

db.adminCommand(
   {
     abortTransaction: 1,
     txnNumber: <long>,
     writeConcern: <document>,
     autocommit: false,
     comment: <any>
   }
)

Behavior

Atomicity

When a transaction aborts, all data changes made by the writes in the transaction are discarded without ever becoming visible and the transaction ends.

Security

If running with auditing, operations in an aborted transaction are still audited.

Back

Sessions Commands

commitTransaction