事务

在事务中创建集合和索引

如果不是跨分片写事务（write transaction），则可以在ACID 事务中执行以下操作：

• 创建集合。

• 在先前同一事务中创建的新空集合上创建索引。

在事务中创建集合时：

• 您可以隐式创建一个集合，例如：

  • 对不存在的集合进行插入操作，或

  • 对不存在的集合使用 upsert: true 进行 update/findAndModify 操作。

• 您可以使用 create 命令或其辅助程序 db.createCollection() 显式创建集合。

在事务内创建索引 [1] 时，要创建的索引必须位于以下位置之一：

• 不存在的集合。集合作为操作的一部分创建。

• 先前在同一事务中创建的新空集合。

计数操作

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

MongoDB 驱动程序提供集合级 API countDocuments(filter, options) 作为辅助方法，该方法使用 $group 和 $sum 表达式来执行计数。

mongosh provides the db.collection.countDocuments() helper method that uses the $group with a $sum expression to perform a count.

去重操作

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

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

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

  要查找分片集合的不同值，请改用带有 $group 阶段的 aggregation pipeline。例如：

  • 不使用 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 ] }

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

信息操作

事务中允许使用诸如 hello、buildInfo、connectionStatus（及其辅助方法）之类的信息命令，但它们不能是事务中的第一项操作。

限制性操作

事务中不允许执行以下操作：

• 在跨分片写事务中创建新集合。例如，如果您在一个分片中写入一个现有集合，并在另一个分片中隐式创建一个集合，那么 MongoDB 将无法在同一事务中执行这两项操作。

• 使用 "local" 以外的读关注级别时，显式创建集合（例如 db.createCollection() 方法）和索引（例如 db.collection.createIndexes() 和 db.collection.createIndex() 方法）。

• listCollections 和 listIndexes 命令及其辅助方法。

• 其他非 CRUD 和非信息性操作（例如 createUser、getParameter 和 count）及其辅助程序。

• 并行操作。要同时更新多个命名空间，请考虑改用 bulkWrite 命令。

事务和读取偏好

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

使用驱动程序，您可以在事务启动时设置事务级读取偏好：

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

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

Transactions that contain read operations must use read preference primary. All operations in a given transaction must route to the same member.

事务和读关注

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

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

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

• 如果未设置事务级读关注和会话级读关注，则事务级读关注默认为客户端级读关注。默认情况下，对于主节点上的读取，客户端级读关注是 "local"。另请参阅：

  • 事务和读取偏好

  • MongoDB默认

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

事务和写关注

事务使用事务级写关注（write concern）来提交写入操作。事务内的写入操作必须在没有显式写关注（write concern）规范的情况下运行，并使用默认的写关注（write concern）。在提交时，使用事务级写关注（write concern）提交写入。

您可以在事务启动时设置事务级写关注。

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

• 如果未设置事务级别的写关注和会话级别的的写关注，则事务级别的写关注默认为 的客户端级别的写关注，

  • w: "majority"（在 MongoDB 5.0 及更高版本中），包含仲裁节点的部署有所不同。请参阅隐式默认写关注。

  • w: 1

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

生产环境注意事项

有关生产环境中的事务，请参阅生产环境注意事项。此外，有关分片集群，请参阅生产环境注意事项（分片集群）。

仲裁节点

Since arbiters are voting replicas that don't contain data, MongoDB protects your data and prevents multi-shard data transactions from targeting shards whose replica sets include an arbiter. This includes changing a shard key using a transaction.

如果任何ACID 事务操作读取或写入包含仲裁节点的分片，MongoDB会阻止写入操作跨越多个分片的事务。

分片配置限制

To run transactions on a sharded cluster, writeConcernMajorityJournalDefault must be set to true.

诊断

要获取事务状态和指标，请使用以下方法：

特征兼容性版本 (FCV)

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

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

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

更多信息，请参阅 setFeatureCompatibilityVersion 参考页。

存储引擎

事务 在以下情况下，副本集和分片的集群支持：

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

• 从节点使用 WiredTiger 存储引擎或内存存储引擎。

限制关键部分等待时间

从 MongoDB 5.2（和 5.0.4）开始：

• 当查询访问分片时，数据段迁移或 DDL 操作可能会占用集合的关键部分。

• 要限制分片在事务中等待关键部分的时间，使用 metadataRefreshInTransactionMaxWaitMS 参数。

  注意

  从MongoDB 8.1 开始，旧的 metadataRefreshInTransactionMaxWaitBehindCritSecMS 参数已重命名为 metadataRefreshInTransactionMaxWaitMS。您可以继续使用 metadataRefreshInTransactionMaxWaitBehindCritSecMS 作为参数名称，但它已弃用，并将在未来的MongoDB发布中删除。