可重试写入

前提条件¶

可重试写入具有以下要求：

支持的部署拓扑

可重试的写入需要副本集 或分片群集，并且不 支持独立实例。

支持的存储引擎

可重试写入需要支持文档级锁定的存储引擎，例如WiredTiger或 内存中的存储引擎。

3.6+ MongoDB驱动程序

客户端需要为MongoDB 3.6或更高版本更新的MongoDB驱动程序：

Java 3.6+ Python 3.6+ C 1.9以上

C＃2.5以上 节点3.0+ Ruby2.5+

Perl 2.0以上 PHPC 1.4以上 Scala 2.2+

MongoDB版本

集群中每个节点的MongoDB版本必须3.6大于或等于，集群中每个节点的MongoDB版本必须大于或featureCompatibilityVersion等于3.6。有关标志的setFeatureCompatibilityVersion更多信息，请参见 featureCompatibilityVersion。

致谢函

与发出写操作写入关注的0 是不重试。

重试写入和多文档交易¶

该交易提交和中止操作 是重试写操作。如果提交操作或中止操作遇到错误，则MongoDB驱动程序将重试该操作一次，无论是否retryWrites将其设置为 false。

事务的写操作不可单独重试，而不管其值是多少retryWrites。

有关交易的更多信息，请参见交易。

启用可重试写入¶

MongoDB驱动程序

需要与MongoDB 3.6和4.0兼容的官方驱动程序，包括retryWrites=true在连接字符串中的选项才能 为该连接启用可重试的写入。

与MongoDB 4.2兼容的官方驱动程序默认情况下启用可重试写入。升级到需要兼容重写的4.2兼容驱动程序的应用程序可以忽略该retryWrites=true 选项。应用升级到需要的4.2兼容的驱动程序 禁用重试写操作必须包括 retryWrites=false连接的字符串中。

mongo 贝壳

要在mongo外壳中启用可重试写入，请使用--retryWrites命令行选项：

复制

mongo --retryWrites

重试写操作¶

当发出已确认的写入问题时，以下写入操作可以重试；例如，写关注点 不能为。{w: 0}

行为¶

{ _id : 1 }

db.collName.updateOne(
  { _id : ObjectId("1aa1c1efb123f14aaa167aaa") },
  { $set : { fieldA : 25 } },
  { upsert : true }
)

{ fieldA : 1 }

db.collName.updateOne(
  { fieldA : { $in : [ 25 ] } },
  { $set : { fieldB : "someValue" } },
  { upsert : true }
)

{
  fieldA : 1,
  fieldB : 1
}

db.collName.updateOne(
  { fieldA : 25, fieldB : "someValue" },
  { $set : { fieldC : false } },
  { upsert : true }
)

{ fieldA : 1 }

db.collName.updateOne(
  { fieldA : { $lte : 25 } },
  { $set : { fieldC : true } },
  { upsert : true }
)

{ fieldA : 1 }

db.collName.updateOne(
  { fieldA : { $in : [ 25 ] } },
  { $set : { fieldA : 20 } },
  { upsert : true }
)

{ _id : 1 }

db.collName.updateOne(
  { fieldA : { $in : [ 25 ] } },
  { $set : { fieldA : 20 } },
  { upsert : true }
)

{ fieldA : 1 }

db.collName.updateOne(
  { fieldA : 25, fieldC : true },
  { $set : { fieldD : false } },
  { upsert : true }
)