Write Concern写关注
在本页面
[success] Note
写关注可包括以下字段:
{ w : < value > , j : < boolean > , wtimeout : < number > }
w
选项请求确认写操作已传播到指定数量的mongod实例或具有指定标记的mongod实例。使用
w
选项,可以使用以下**w:<value
>**写入问题:也可以看看
[success] Note
如果启用日记功能,则可能暗示。的 副本集配置设置确定的行为。有关详细信息,请参见 确认行为。[w: "majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")`j: true[
writeConcernMajorityJournalDefault`](https://docs.mongodb.com/manual/reference/replica-configuration/#rsconf.writeConcernMajorityJournalDefault). 如果日志是启用的,[w: "majority"
](https://docs.mongodb.com/master/reference/write-concern/#writeconcern."majority") 可能意味着j:true。writeConcernMajorityJournalDefault
复制集配置设置决定了行为。有关详细信息,请参阅确认行为 。
此选项指定写入问题的 time 限制(以毫秒为单位)。
wtimeout
仅适用于大于1
的w
值。wtimeout
导致写入操作返回到指定限制后的错误,即使所需的写入关注最终会成功。当这些写操作 return 时,MongoDB 不会撤消在写入关注超过wtimeout
time 限制之前执行的成功数据修改。如果未指定
wtimeout
选项且写入关注的 level 无法实现,则写入操作将无限期阻止。指定0
的wtimeout
value 等同于没有wtimeout
选项的写入问题。 | j 未指定 | j:true | j:false |
w: 1 | 在记忆中 | 磁盘日志 | 在内存中 |
w: "majority" | 磁盘日志(如果与日志一起运行) | 磁盘日志 | 在内存中 |
[success] Note随着writeConcernMajorityJournalDefault
设置为false
,MongoDB的不等待 写入承认写之前被写入到磁盘上的日志。这样,在给定副本集中的大多数节点出现瞬时丢失(例如崩溃和重新启动)的情况下,写操作可能会回滚。[w: "majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")`majority`
w: "majority"
复制集的任何带有数据的投票成员都可以对[
"majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")写操作进行写确认。j 是不确定的 | 确认取决于 writeConcernMajorityJournalDefault 的值: 如果为true,确认需要对磁盘上的日志进行写入操作(j: true) writeConcernMajorityJournalDefault 默认为true 如果为false,确认需要在内存中进行写入操作(j: false)。 |
j: true | 确认需要对磁盘日志进行写入操作。 |
j: false | 确认需要在内存中进行写入操作。 |
[success] Note
w: <
number
>j 未指定 | 确认需要在内存中进行写操作(j: false)。 |
j: true | 确认需要将操作写入磁盘日志。 |
j: false | 确认需要在内存中进行写操作。 |
- 相关的写操作使用[
"majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority") 写关注。
-
writeConcernMajorityJournalDefault
设置为false,MongoDB不等待[w: "majority"
](https://docs.mongodb.com/master/reference/write-concern/#writeconcern."majority") 写入被写入到磁盘日志之前,确认写入,因此,在给定复制集中的大多数节点出现短暂损失(例如崩溃和重新启动)时,大多数写操作可能会回滚。 - 隐藏的, 延迟的, and priority 0的成员,成员数为[n]。投票大于0可以确认[
"majority"
](https://docs.mongodb.com/master/reference/write-concern/#writeconcern."majority") ”写操作。
提示
- 所有投票成员(包括仲裁员)中的大多数
- 所有带有数据的投票成员的数量。
[warning] 警告如果计算出的多数数等于所有带有数据的投票成员的人数(例如,由3个成员组成的主要-次要仲裁员部署),则写关注 ["majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")可能会超时,或者如果有数据的投票成员则永远不会得到承认掉线或无法到达。如果可能,请使用带有数据的投票成员而不是仲裁者。
例如,考虑:
- 具有3个投票成员的复制集,主要-次要(PSS):
- 所有投票成员中大多数为2。
- 所有有数据投票的成 员人数为3。
计算得出的多数为2,最小值为2和3。写入必须传播到主要对象和辅助对象之一,[
"majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")以向客户端确认写入问题。- 复制集包含3个投票成员,主要-次要仲裁员(PSA)
- 所有投票成员中大多数为2。
- 所有有数据投票的成员人数为2。
计算得出的多数为2,为2和2的最小值。由于该写操作只能应用于数据承载成员,因此该写操作必须传播到主要对象和辅助对象,[
"majority"
](https://docs.mongodb.com/manual/reference/write-concern/#writeconcern."majority")以向客户端确认写问题。提示避免在a (p - a)或其他拓扑结构中使用“多数”写关注点,这些拓扑结构要求所有支持数据的投票成员都可用来确认写操作。想要使用**“majority”**写关注点的持久性保证的客户应该部署不需要所有数据承载投票成员可用的拓扑(例如P-S-S)。
从4.4版本开始,MongoDB跟踪写关注点的来源,它表示一个特定的写关注点的来源。您可能会在
getLastError
指标、write concern error对象和MongoDB日志中看到显示出处的信息。下表显示了可能的写问题provenance值及其重要性:
Provenance | Description |
---|---|
clientSupplied | 写关注点是在应用程序中指定的。 |
customDefault | |
getLastErrorDefaults | |
implicitDefault | 在没有其他所有写关注规范的情况下,写关注源自服务器。 |
译者:杨帅 张琦
校对:杨帅
最近更新 1yr ago