WriteConcern
版本信息
当前版本
v1.0
版本历史
<html>
<table class="table table-bordered table-striped table-condensed">
<tr>
<td>版本</td>
<td>更新时间</td>
<td>更新人</td>
<td>更新内容</td>
</tr>
<tr>
<td>v1.0</td>
<td>2015/10/14</td>
<td>刘蕴唐</td>
<td>初步编写</td>
</tr>
</table>
</html>
简介
Write concern描述了当报告成功写入时,MongoDB所提供的保证。write concern的强度决定了保证的程度。
- 对于拥有弱write concern的插入、更新、删除操作,写入操作快速返回;某些情况下,写入的数据并不会插入到数据库中
- 对于强write concern的写入,客户端等待MongoDB确认写入完成。
MongoDB提供了多个不同几倍的write concern来更好地解决不同应用的特定需求。客户端可以调整write concern的值来确保最重要的操作总是能够安全写入。对于不是那么关键的操作,可以优先考虑速度。
详细介绍
Write Concern
等级从弱到强,MongoDB提供了不同等级的Write Concern
Unacknowledged不答复
MongoDB不对客户端进行答复,驱动需要检查网络错误等。
Acknowledged答复
这是默认值。MongoDB会确认受收到写入操作并且确认该操作在内存中应用。允许客户端捕捉网络、重复key等等错误。
不会确认数据是否写到硬盘中
Journaled记录到日志
MongoDB会在将数据提供到日志后,答复客户端,这样就允许断电、关机等意外情况后恢复数据。
必须允许了日志功能,才能生效。
写入操作必须等待直到下次提交日志。为了减少延迟,MongoDB增加了将操作提交到日志的频率。查看storage.mmapv1.journal.commitIntgervalMs来获得更多信息
对于集群,只需要等待日志提交发生主要节点
Replica Acknowledged集群答复
需要考虑的因素
默认级别
shell和驱动使用答复作为默认基本
超时
只和集群有关
配置
升级
从2.6版本开始,写入操作提供了新的协议,整合了写入操作和write concren,并且不需要执行命令getLastError。之前的版本要求在写入操作后立即执行getLastError命令,用于指定write concern
可用的write concern
Write Concern可以包含以下选项
- w 指定在返回前所需要答复数量
- j 指定在返回前,需要写入到日志
- wtimeout 指定了超时
w选项
MongoDB使用w:1作为默认值。可选值和含义如下:
- 1 对于单个的mongod或者集群的主要节点,提供了答复
- 0 禁止最基本的答复功能,只提供了关于套接字异常和网络错误的信息给客户端。如果禁止答复的同时要求日志,那么日志请求会被执行,服务器会进行答复
- 大于1 针对集群,要求1个主节点和w-1个从节点答复,如果w的值大于主节点和从节点的和,那么会一直阻塞直到别的节点上线
- majority 针对集群,要求所有投票节点的大部分进行答复。这样就避免了硬编码的节点数量,更加灵活。在3.0版本之前,对应的是成员节点的大部分。
j选项
确定mongod实例将数据写入到磁盘日志。值为bool值。
wtimeout针对集群
mgo中对应的处理
类型
mgo支持MongoDB所有的write concern参数,使用类型mgo.Safe来表示,定义如下:
type Safe struct
{
W int
WMode string
WTimeOut int
FSync bool
J boo
l}
- Safe将MongoDB的w参数分解为W WMode两个字段,因为go是有类型的。
- WTimeOut/J参数也一一对应
- 至于FSync,日后再谈
方法
有两个方法来设置
- (*mgo.Session)EnsureSafe(safe *Safe)来设置,会逐个字段比较参数和当前所用的值,选择更保守的字段
-
(*mgo.Session)SetSafe(safe *Safe),重新设置,参数可以为空
有一个方法来获取当前的设置 - (*mgo.Session)Safe() *Safe