版本信息

当前版本

v1.0

版本历史

简介

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

WriteConcern