事务操作

本页中

• 支持多文档事务的操作

• CRUD 操作

• Count 操作

• Distinct 操作

• 信息操作

• 限制的操作

对于事务来说：

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

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

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

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

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

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

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

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

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

多文档事务支持的操作

CRUD 操作

事务中允许以下读/写操作：

方法	命令	备注
db.collection.aggregate()	aggregate	不包括以下阶段：$collStats$currentOp$indexStats$listLocalSessions$listSessions$merge$out$planCacheStats
db.collection.countDocuments()		不包含以下查询运算符表达式：$where$near$nearSphere 。该方法使用$match聚合阶段进行查询，并使用$group聚合阶段带有$sum表达式来执行计数。
db.collection.distinct()	distinct	在未分片集合中可用。对于分片集合，请在 $group阶段使用聚合管道。可查看Distinct Operation。
db.collection.find()	find
	geoSearch
db.collection.deleteMany()db.collection.deleteOne()db.collection.remove()	delete
db.collection.findOneAndDelete()db.collection.findOneAndReplace()db.collection.findOneAndUpdate()	findAndModify	仅在针对现有集合运行时使用upsert。
db.collection.insertMany()db.collection.insertOne()db.collection.insert()	insert	仅在针对现有集合运行时使用。
db.collection.save()		如果插入，则仅在针对现有集合运行时。
db.collection.updateOne()db.collection.updateMany()db.collection.replaceOne()db.collection.update()	update	仅在针对现有集合运行时使用upsert。
db.collection.bulkWrite()Various Bulk Operation Methods		如果插入，则仅在针对现有集合运行时。仅在针对现有集合运行时使用upsert。

分片键值更新

从MongoDB 4.2开始，您可以通过在事务中发出单文档update / findAndModify操作或作为可重试写来更新文档的分片键值（除非分片键字段是不可变的_id字段）。有关详细信息，请参见 更改文档的分片健值.

计数操作

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

与4.0功能兼容的MongoDB驱动程序提供了一个集合级APIcountDocuments（filter，options）作为辅助方法，该方法使用带有 $group 表达式和$sum 表达式的计数方法。 4.0驱动程序已弃用count（）API。

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

Distinct 操作

在事务中执行distinct操作：

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

• 对于分片集合，不能使用 db.collection.distinct() 方法或 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操作和事务

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

译者：王金铷