CRUD操作可重试写入使用的先决条件部署的限制支持的存储引擎3.6

MongoDB

可重试写入和多文档事务启用可重试写入MongoDB驱动mongosh

可重试的写操作行为持续的网络错误故障切换周期诊断针对本地数据库的可重试写入错误处理

Writes是一种容错机制旨在提高数据库操作的可靠性和稳定性。

用于在遇到网络波动、副本集节点故障等临时性问题时自动重新执行写操作。

这种机制的目的是确保数据能够安全、准确地写入数据库从而增强数据库的鲁棒性和可用性。

WiredTiger

集群中每个节点的MongoDB版本必须为3.6或更高版本集群中每个节点的featureCompatibilityVersion必须为3.6或更高版本。

有关

setFeatureCompatibilityVersion。

写确认

事务提交和中止操作是可重试的写操作。

如果提交操作或中止操作遇到错误MongoDB

驱动程序会重试该操作一次无论

及更高版本兼容的驱动程序默认启用可重试写入。

早期的驱动程序需要

retryWritestrue

方法说明db.collection.insertOne()插入操作db.collection.insertMany()插入操作db.collection.updateOne()单文档更新操作db.collection.replaceOne()单文档更新操作db.collection.deleteOne()单文档删除db.collection.remove()其中justOne为true单文档删除db.collection.findAndModify()单文档更新db.collection.findOneAndDelete()单文档删除db.collection.findOneAndReplace()单文档更新db.collection.findOneAndUpdate()单文档更新db.collection.bulkWrite()的写操作insertOne、updateOne、replaceOne、deleteOne只包含单文档写入操作的批量写入操作。

可重试的批量操作可包括指定写入操作的任何组合但不能包括任何多文档写入操作如updateManyBulk操作的Bulk.find.removeOne()、Bulk.find.replaceOne()、Bulk.find.updateOne()只包含单文档写入操作的批量写入操作。

可重试的批量操作可以包括指定写入操作的任何组合但不能包括任何多文档写入操作例如为多选项指定为true的更新

MongoDB的可重试写入只进行一次重试尝试这会有助于解决瞬时网络错误和副本集选举问题但不能解决持续性网络错误。

故障切换周期

如果驱动程序在目标副本集或分片集群分片中找不到运行状况良好的主数据库则驱动程序将等待serverSelectionTimeoutMS毫秒以确定新的主数据库然后再重试。

可重试写入不能解决故障转移时间超过serverSelectionTimeoutMS的情况。

如果客户端应用程序在发出写入操作后无响应的时间超过localLogicalSessionTimeoutMinutes则当客户端应用程序开始响应无需重新启动时可能会重试并再次应用写入操作。

shell辅助程序db.serverStatus()包含事务部分中可重试写入的统计数据。

MongoDB

官方驱动程序默认启用可重试写入除非显式禁用可重试写入否则写入本地数据库的应用程序会遇到写入错误。

要禁用可重试写入可在MongoDB集群的连接字符串中指定retryWritesfalse。

错误处理

6.1开始如果可重试写入的第一次和第二次尝试都失败而没有执行单个写入则返回带有NoWritesPerformed标签的错误。

NoWritesPerformed标签区分批处理操作如

insertMany()的结果。

在insertMany操作中可能会出现以下结果之一

结果MongoDB输出没有插入任何文档使用NoWritesPerformed标签返回错误部分工作已完成。

至少插入一份文档但不是全部。

没有NoWritesPerformed标签时返回错误所有文档均已插入成功返回

应用程序可以使用NoWritesPerformed标签来明确没有插入任何文档该错误报告让应用程序可以在处理可重试写入时保持数据库的准确状态。

在MongoDB的早期版本中当第一次和第二次可重试写入尝试失败时会返回错误。

但没有任何区别来表明没有执行写入。