MongoDB事务
在本页
在MongoDB中,对单个文档的操作是原子的。因为您可以使用嵌入式文档和数组来捕获单个文档结构中的数据之间的关系,而不是在多个文档和集合之间进行规范化,所以这种单文档原子性消除了许多实际用例中对多文档事务的需求。
对于需要原子性地读写多个文档( 在单个或多个集合中)的情况,MongoDB支持多文档事务。使用分布式事务,可以跨多个操作,集合,数据库,文档和分片使用事务。
以下示例重点介绍了事务API的关键组成:
- PYTHON
- JAVA (SYNC)
- NODE.JS
- PHP
- MOTOR
- C
- C++11
- C#
该示例使用新的回调API来处理事务,该API启动事务,执行指定的操作并提交(可能因为错误而中止)。新的回调API还针对
TransientTransactionError
或UnknownTransactionCommitResult
提交错误合并了重试逻辑。重点
- 对于MongoDB 4.2(副本集和分片群集)上的事务,客户端必须使用将MongoDB驱动程序更新为MongoDB 4.2。
- 使用驱动程序时,事务中的每个操作必须与会话相关联(即,将每个操作传递在会话中传递)。
参考
分布式事务和多文档事务
从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。- 当事务中止时,在事务中进行的所有数据更改都将被丢弃,而不会变得可见。 例如,如果事务中的任何操作失败,则事务中止,并且在事务中进行的所有数据更改都将被丢弃,而不会变得可见。
重点
在大多数情况下,与单文档写入相比,多文档事务产生的性能成本更高,并且多文档事务的可用性不应替代有效的架构设计。 在许多情况下, 非规范化数据模型(嵌入的文档和数组) 仍将是最佳选择您的数据和用例。 也就是说,在许多情况下,适当地对数据建模将最大程度地减少对多文档交易的需求。
分布式事务可用于多个操作,集合,数据库,文档,以及从MongoDB 4.2分片开始的。
对于事务:
- 您无法在
config
,admin
或local
数据库中读取/写入集合。 - 您无法写入
system。*
集合。 - 您无法返回支持的操作的查询计划(如
explain
)。
提示
在事务中执行不同的操作:
- 代替
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 ] }迭代光标以访问结果文档。
事务中不允许以下的操作:
- 影响数据库目录的操作,例如创建或删除集合或索引。 例如,事务不能包含将导致创建新集合的插入操作。
可参考
- 事务与会话关联; 即您开始一个会话的事务。
- 在任何给定时间,一个会话最多只能有一个未完成的事务。
- 使用驱动程序时,事务中的每个操作必须与会话关联。 有关详细信息,请参阅驱动程序专用文档。
- 如果会话结束并且具有打开的事务,则事务中止。
- 如果未设置事务级别的读取首选项,则事务将使用会话级别的读取首选项。
事务支持以下读关注级别:
提示:
不要为事务中的各个写操作明确设置写关注。 为事务中的各个写操作设置写关注点将导致错误。
- 如果未设置事务级写关注,则事务级写关注默认为提交的会话级写关注。
重要
注意
如果任何事务操作读取或写入包含仲裁程序的分片,则其写操作跨越多个分片的事务将出错并中止。
一个含有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” 。注意
MongoDB提供了各种指标:
方法 | Text |
---|---|
如果操作是事务的一部分,则返回 $currentOp.transaction 。 无效会话 的信息作为事务的一部分持有锁。$currentOp.twoPhaseCommitCoordinator 这些指标涉及向多个分片写入的分片事务。 | |
部署 | Minimum featureCompatibilityVersion //最小FCV |
副本 | 4.0 |
分片 | 4.2 |
要检查成员的FCV,请连接到该成员并运行以下命令:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
- 主节点使用WiredTiger存储引擎,并且
在MongoDB 4.0中,仅使用WiredTiger存储引擎的副本集支持事务。
注意:
译者:王金铷

MongoDB中文社区—MongoDB爱好者技术交流平台
资源列表推荐 | 资源入口 |
---|---|
MongoDB中文社区官网 | |
微信服务号 ——最新资讯和优质文章 | Mongoing中文社区(mongoing-mongoing) |
微信订阅号 ——发布文档翻译内容 | MongoDB中文用户组(mongoing123) |
官方微信号 —— 官方最新资讯 | MongoDB数据库(MongoDB-China) |
MongoDB中文社区组委会成员介绍 | |
MongoDB中文社区翻译小组介绍 | |
MongoDB中文社区微信技术交流群 | 添加社区助理小芒果微信(ID:mongoingcom),并备注 mongo |
MongoDB中文社区会议及文档资源 | |
MongoDB中文社区大咖博客 | |
MongoDB白皮书 | |
MongoDB初学者教程-7天入门 | |
社区活动邮件订阅 |
最近更新 1yr ago