MongoDB事务

在本页

• 事务API

• 事务和原子性

• 事务和操作

• 事务和会话

• 读策略/写策略/读偏好

• 一般信息

• 其他事务问题

在MongoDB中，对单个文档的操作是原子的。因为您可以使用嵌入式文档和数组来捕获单个文档结构中的数据之间的关系，而不是在多个文档和集合之间进行规范化，所以这种单文档原子性消除了许多实际用例中对多文档事务的需求。

对于需要原子性地读写多个文档（在单个或多个集合中）的情况，MongoDB支持多文档事务。使用分布式事务，可以跨多个操作，集合，数据库，文档和分片使用事务。

事务API

以下示例重点介绍了事务API的关键组成：

译者注，原文可看不同类型的代码

• PYTHON

• JAVA (SYNC)

• NODE.JS

• PHP

• MOTOR

• C

• C++11

• C#

该示例使用新的回调API来处理事务，该API启动事务，执行指定的操作并提交（可能因为错误而中止）。新的回调API还针对 TransientTransactionError 或UnknownTransactionCommitResult 提交错误合并了重试逻辑。

重点

• 对于MongoDB 4.2（副本集和分片群集）上的事务，客户端必须使用将MongoDB驱动程序更新为MongoDB 4.2。

• 使用驱动程序时，事务中的每个操作必须与会话相关联（即，将每个操作传递在会话中传递）。

参考

比如，在mongo shell中参考 mongo Shell Example.

事务和原子性

分布式事务和多文档事务

从MongoDB 4.2开始，这两个术语是同义词。 分布式事务是指分片群集和副本集上的多文档事务。 从MongoDB 4.2开始，多文档事务（无论是在分片群集或副本集上）也称为分布式事务。

对于需要原子性地读写多个文档（在单个或多个集合中）的情况，MongoDB支持多文档事务：

• 在4.0版中，MongoDB支持副本集上的多文档事务。

• 在版本4.2中，MongoDB引入了分布式事务，它增加了对分片群集上多文档事务的支持，并合并了对副本集上多文档事务的现有支持。

要在MongoDB 4.2部署（副本集和分片群集）上使用事务，客户端必须使用为MongoDB 4.2更新的MongoDB驱动程序。

多文档交易是原子性的（即提供“全有或全无”主张）：

• 提交事务时，将保存在事务中进行的所有数据更改，并在事务外部可见。 也就是说，一个事务在回滚其他事务时将不会提交其某些更改。在提交事务之前，在事务外部看不到在事务中进行的数据更改。

但是，当事务写入多个分片时，并非所有外部读取操作都需要等待已提交事务的结果在所有分片上可见。 例如，如果提交了一个事务，并且在分片A上可以看到写1，但是在分片B上却看不到写2，则外部读取时设置读关注 "local" 结果为可以读取写入1的结果而看不到写入2。

• 当事务中止时，在事务中进行的所有数据更改都将被丢弃，而不会变得可见。 例如，如果事务中的任何操作失败，则事务中止，并且在事务中进行的所有数据更改都将被丢弃，而不会变得可见。

重点

在大多数情况下，与单文档写入相比，多文档事务产生的性能成本更高，并且多文档事务的可用性不应替代有效的架构设计。 在许多情况下， 非规范化数据模型（嵌入的文档和数组） 仍将是最佳选择您的数据和用例。 也就是说，在许多情况下，适当地对数据建模将最大程度地减少对多文档交易的需求。

有关其他事务使用方面的注意事项（例如运行时限制和oplog大小限制），另请参阅生产注意事项.

也可参考提交期间的外部读取

事务和操作

分布式事务可用于多个操作，集合，数据库，文档，以及从MongoDB 4.2分片开始的。

对于事务：

• 您可以在现有集合上指定读/写（CRUD）操作。集合可以在不同的数据库中。有关CRUD操作的列表，请参考 CRUD 操作。

• 您无法写入 capped 集合。 （从MongoDB 4.2开始）

• 您无法在config，admin或local数据库中读取/写入集合。

• 您无法写入system。*集合。

• 您无法返回支持的操作的查询计划（如 explain）。

• 对于在事务外部创建的游标，不能在事务内部调用 getMore 。

• 对于在事务中创建的游标，不能在事务外调用 getMore 。

• 从MongoDB 4.2开始，您不能将 killCursors 指定为事务的第一个操作。

事务中不允许执行影响数据库目录的操作，例如创建或删除集合或索引。例如，事务不能包含将导致创建新集合的插入操作。请参阅受限操作。

提示

创建或删除集合后立即开始事务，如果在事务内访问了该集合，请在创建或者删除时设置write concern为 "majority" ，以确保该事务可以获取所需的锁。

可参考：事务和操作参考

count 操作

要在事务中执行计数操作，请使用 $count 聚合阶段或者 $group （带有 $sum 表达式）聚合阶段。

与4.0功能兼容的MongoDB驱动程序提供了一个集合级API countDocuments(filter, options) 作为使用带有$sum 的 $group 表达式进行计数。4.0驱动程序已弃用 count() API。

从MongoDB 4.0.3开始， mongo shell提供使用$sum 的 $group 表达式进行计数的 db.collection.countDocuments() 方法。

distinct 操作

在事务中执行不同的操作：

• 对于未分片的集合，可以使用 db.collection.distinct() 方法或者distinct 命令以及具有 $group 阶段的聚合管道。

• 对于分片集合，不可以使用 db.collection.distinct() 方法或者distinct 命令。

要查找分片集合的不同值，请使用带有 $group 阶段的聚合管道，例如：

• 代替db.coll.distinct("x")，使用

  db.coll.aggregate([
     { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
     { $project: { _id: 0 } }
  ])

• 代替 db.coll.distinct("x", { status: "A" })，使用：

  db.coll.aggregate([
     { $match: { status: "A" } },
     { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
     { $project: { _id: 0 } }
  ])

  管道将游标返回到文档：

  { "distinctValues" : [ 2, 3, 1 ] }

  迭代光标以访问结果文档。

信息类操作

信息命令在事务中是允许的，如 isMaster, buildInfo, connectionStatus （以及辅助方法）；但是他们不能是事务中的第一个操作。

限制的操作

事务中不允许以下的操作：

• 影响数据库目录的操作，例如创建或删除集合或索引。 例如，事务不能包含将导致创建新集合的插入操作。

listCollections 和 listIndexes 命令及其辅助方法也被排除在外。

• 非CRUD和非信息性操作，例如 createUser, getParameter, count等等及其辅助命令。

可参考

• 待处理的DDL操作和事务

• 事务和操作参考

事务和会话

• 事务与会话关联； 即您开始一个会话的事务。

• 在任何给定时间，一个会话最多只能有一个未完成的事务。

• 使用驱动程序时，事务中的每个操作必须与会话关联。 有关详细信息，请参阅驱动程序专用文档。

• 如果会话结束并且具有打开的事务，则事务中止。

读关注/写关注/读偏好

事务和读偏好

事务中的操作使用事务级别的读偏好。

使用驱动程序，可以在事务开始时设置事务级别的 读偏好 ：

• 如果未设置事务级别的读取首选项，则事务将使用会话级别的读取首选项。

• 如果未设置事务级别和会话级别的读选项，则事务将使用客户端级别的读偏好。 默认情况下，客户端级别的读选项为primary。

包含读取操作的多文档事务必须使用读偏好primary。 给定事务中的所有操作都必须路由到同一成员。

事务和读关注

事务中的操作使用事务级别的读关注。 也就是说，在事务内部忽略在集合和数据库级别设置的任何读取关注。

您可以在事务开始时设置事务级别的读关注。

• 如果未设置事务级读关注，则事务级读关注默认为会话级读关注。

• 如果未设置事务级别和会话级别的读关注，则事务级别的读取关注点默认为客户端级别的读关注。 默认情况下，对于主服务器的读取，客户端级别的读关注为“ local”。 另请参见事务和读选项。

事务支持以下读关注级别：

"local"

• 读关注点“ local”返回该节点可用的最新数据，但可以回滚。

• 对于分片群集上的事务，“ local”读关注不能保证数据是从整个分片的同一快照视图获取。 如果需要快照隔离，请使用“snapshot”读关注。

"majority"

• 如果以写关注“majority”提交事务，读关注 "majority"返回大多数副本成员已确认的数据（即无法回滚数据）。

• 如果事务未使用 写关注“majority” 进行提交，则“majority”读关注不保证读操作可以读取多数提交的数据。

• 对于分片群集上的事务，“majority”读取关注不能保证数据是从整个分片的同一快照视图中获取。 如果需要快照隔离，请使用“snapshot”读关注。

"snapshot"

• 如果事务提交时带有写关注“majority”，读关注"snapshot"从大多数已提交数据的快照中返回数据。

• 如果事务未使用写关注“majority”进行提交，则"snapshot"读关注不保证读操作使用了大部分提交的数据的快照。

• 对于分片群集上的事务，数据的"snapshot"视图 跨分片同步。

事务和写关注

事务使用事务级别的写关注进行写操作。 必须在没有显式写关注规范的情况下发出事务内部的写操作，并使用默认写关注。 在提交时，然后使用事务级写关注来提交写操作。

提示：

不要为事务中的各个写操作明确设置写关注。 为事务中的各个写操作设置写关注点将导致错误。

您可以在事务开始时设置事务级别的写关注：

• 如果未设置事务级写关注，则事务级写关注默认为提交的会话级写关注。

• 如果未设置事务级写关注和会话级写关注，则事务级写关注默认为客户端级写关注。 默认情况下，客户端级别的写入问题为w：1。

事务支持所有写关注w值，包括：

w: 1

• 在主节点提交写关注w：1后返回确认。

重要

当您使用w：1提交时，您的事务如果存在故障则可以回滚。

• 当您提交w：1时，会写成事物级别的“majority” 读关注，不保证事务中的读取操作会读取多数提交的数据 。

• 当您提交w：1时，会写成事务级别的"snapshot"，读取关注不保证事务中的读取操作使用多数快照提交的数据。

w: "majority"

• 在提交已应用于多数（ M）有投票权的成员后，写关注w：“majority”返回确认； 即提交已应用于主要和（M-1）个投票辅助。

• 当您提交w：“ majority”时，事务级别的“ majority “读关注保证了操作已读取多数提交的数据。 对于分片群集上的事务，大多数分批提交的数据的视图不会在分片之间同步。

• 当您使用w：“majority”提交时，事务级别“快照 “读关注保证操作来自大多数提交的数据的同步快照。

注意

不管事务指定的写关注，分片集群事务的提交操作都包含使用{w：“多数”，j：是}写关注。

一般信息

注意事项

有关使用事务的各种注意事项，请参阅注意事项。 另外，分片群集，另请参见注意事项（分片群集）。

仲裁者

如果任何事务操作读取或写入包含仲裁程序的分片，则其写操作跨越多个分片的事务将出错并中止。

另请参见禁用读关注Majority，以了解已禁用读关注majority的分片的事务限制。

禁用读关注Majority

一个含有3成员PSA（主-次-仲裁器）副本集，或具有3成员PSA分片的分片群集可能已禁用读关注Majority（--enableMajorityReadConcern false 或replication.enableMajorityReadConcern：false)

• 对于分片集群：

如果事务涉及的分片具有禁用读关注Majority，则事务中不能使用的读关注“快照”。 您只能在事务中使用读关注的“ local”或“majority”。 如果使用读关注“ snapshot”，则事务错误并中止。

当enableMajorityReadConcern = false时，分片群集中不支持读关注级别 'snapshot' 。

如果任何事务的读或写操作涉及禁用了读关注"majority"的分片，则其写操作跨越多个分片的事务将出错并中止。

• 在已禁用读关注“majority”副本集中，您可以指定读关注“ local”或“majority”或“snapshot”。但是，如果您打算过渡到具有禁用读关注majority分片的分片群集，则避免使用读关注的"snapshot"。

提示：

检查是否已禁用读关注“majority”，可以在 mongod上运行db.serverStatus（）并检查storageEngine.supportsCommittedReads字段。 如果为“ false”，则禁用读关注“majority” 。

有关更多信息，请参阅3-成员主-从-仲裁者体系结构和三成员主-从-仲裁者 分片。

分片配置限制

您不能在writeConcernMajorityJournalDefault设置为“ false”的分片群集上运行事务（ 如 使用内存存储引擎的具有投票成员的分片）。

注意

不管为事务指定的写关注，分片集群事务的提交操作都包含使用{w：“majority”，j：true}写关注。

诊断

MongoDB提供了各种指标：

方法
db.serverStatus() 方法serverStatus命令	返回 事务 指标。
$currentOp 聚合管道	如果操作是事务的一部分，则返回$currentOp.transaction。 无效会话 的信息作为事务的一部分持有锁。$currentOp.twoPhaseCommitCoordinator 这些指标涉及向多个分片写入的分片事务。
db.currentOp() 方法currentOp 命令	如果操作是事务的一部分，则返回currentOp.transaction 。currentOp.twoPhaseCommitCoordinator 这些指标涉及写入多个分片的分片事务。
mongod 和 mongos日志信息	包括TXN日志组件下慢事务信息（即超过operationProfiling.slowOpThresholdMs阈值的事务信息）。

功能兼容版本 (FCV)

要使用事务，部署的所有成员的featureCompatibilityVersion必须至少为：

部署	Minimum featureCompatibilityVersion//最小FCV
副本	4.0
分片	4.2

要检查成员的FCV，请连接到该成员并运行以下命令：

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

有关更多信息，请参见设置FCV参考页。

存储引擎

从MongoDB 4.2开始，副本集和分片群集支持多文档事务：

• 主节点使用WiredTiger存储引擎，并且

• 从成员使用WiredTiger存储引擎或内存存储引擎

在MongoDB 4.0中，仅使用WiredTiger存储引擎的副本集支持事务。

注意：

您无法在具有writeConcernMajorityJournalDefault设置为“ false”的分片的分片集群上运行事务，例如使用内存存储引擎具有投票成员的分片。

其他事务话题

驱动 API

注意事项

注意事项 (分片集群)

事务和操作

译者：王金铷

原文链接：https://docs.mongodb.com/manual/core/transactions/

MongoDB中文社区

MongoDB中文社区—MongoDB爱好者技术交流平台

资源列表推荐	资源入口
MongoDB中文社区官网	https://mongoing.com/
微信服务号 ——最新资讯和优质文章	Mongoing中文社区（mongoing-mongoing）
微信订阅号 ——发布文档翻译内容	MongoDB中文用户组（mongoing123）
官方微信号 —— 官方最新资讯	MongoDB数据库（MongoDB-China）
MongoDB中文社区组委会成员介绍	https://mongoing.com/core-team-members
MongoDB中文社区翻译小组介绍	https://mongoing.com/translators
MongoDB中文社区微信技术交流群	添加社区助理小芒果微信（ID:mongoingcom），并备注 mongo
MongoDB中文社区会议及文档资源	https://mongoing.com/resources
MongoDB中文社区大咖博客	基础知识 性能优化 原理解读 运维监控 最佳实践
MongoDB白皮书	https://mongoing.com/mongodb-download-white-paper
MongoDB初学者教程-7天入门	https://mongoing.com/mongodb-beginner-tutorial
社区活动邮件订阅	https://sourl.cn/spszjN