Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
数据库命令
/
会话

commitTransaction

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 行为

定义

commitTransaction

将操作所做的更改保存在多文档事务中并结束ACID 事务。

提示

在 mongosh中，该命令也可以通过Session.commitTransaction()和Session.withTransaction()辅助方法运行。

辅助方法对 mongosh 用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

要运行commitTransaction ，必须针对admin数据库运行该命令并在Session()中运行。

兼容性

此命令可用于以下环境中托管的部署：

  • MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

语法

该命令具有以下语法：

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

行为

写关注

提交事务时，会话使用事务开始时指定的写关注。请参阅 Session.startTransaction()。

如果您使用 "w: 1" 写关注进行提交，则可以在存在故障转移时回滚事务。

原子性(Atomicity)

在事务提交时，事务中所做的所有数据更改都会保存，并且在事务之外可见。换言之，一个事务不会在回滚其他事务的同时提交某些更改。

在事务进行提交前，在事务中所做的数据更改在事务外不可见。

不过，当事务写入多个分片时，并非所有外部读取操作都需等待已提交事务的结果在各个分片上可见。例如，如果事务已提交并且写入 1 在分片 A 上可见，但写入 2 在分片 B 上尚不可见，则读关注 "local" 处的外部读取可以在不看到写入 2 的情况下读取写入 1 的结果。

后退

abortTransaction

来年

endSessions