setDefaultRWConcern

レプリカセット

setDefaultRWConcernをレプリカセット プライマリに対して発行します。プライマリから、新しいグローバル デフォルト設定がレプリカセットの残りのノードに複製されます。更新されたグローバルデフォルト設定がまだ複製されていないセカンダリは、引き続きローカルの「古い」デフォルト設定を使用します。

setDefaultRWConcernの writeConcern を指定して コマンドを発行し、変更がレプリカセット ノードの大部分に伝達された後にのみコマンドが返すようにします。w : "majority"

シャーディングされたクラスター

setDefaultRWConcernクラスター内の に対してmongos を発行します。mongosは更新された設定をコンフィギュレーションサーバー レプリカセット（CSRS）に保存します。 各mongosは CSRS に対してgetDefaultRWConcernを定期的に発行して、グローバル設定のローカルコピーを更新します。 mongosは、更新の間隔中にグローバル デフォルトのローカルの「古い」コピーを使用します。

変更が CSRS ノードの大多数に伝播してからのみコマンドを返すようにするには、 writeConcern を w : "majority"に設定してsetDefaultRWConcernコマンドを発行します。

アプリケーションが読み取りまたは書込み保証を明示的に指定せずにmongosに対して操作を発行すると、 mongosは対応するグローバル デフォルト設定を適用します。

グローバル デフォルト設定は、個々のシャードに伝播しません。 シャードに対してsetDefaultRWConcernを実行することはできません。

アクセス制御

自己管理型配置で認証を強制する レプリカセット または シャーディングされたクラスター の場合、 setDefaultRWConcernには認証されたユーザーがsetDefaultRWConcern特権アクションを持っている必要があります。

clusterManager組み込みロール は、 setDefaultRWConcernを実行するために必要な特権を提供します。

グローバルデフォルト書込み保証の設定

以下の操作で、グローバル書込み保証を次のように設定します。

• w: 2

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  }
})

この操作は、次のようなドキュメントを返します。

{
  "defaultWriteConcern" : {
   "w" : 2
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

グローバルのデフォルト読み取り保証を設定

以下の操作で、グローバル読み取り保証を"majority"に設定します。

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : { "level" : "majority" }
})

この操作は、次のようなドキュメントを返します。

{
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

グローバルのデフォルト読み取り保証および書込み保証の設定

以下の操作で、グローバルのデフォルトの読み取りおよび書込み保証を次のように設定します。

• w: 2 書込み保証 (write concern)

• level: "majority" 読み取り保証 (read concern)。

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  },
  "defaultReadConcern" : { "level" : "majority" }
})

この操作は、次のようなドキュメントを返します。

"defaultWriteConcern" : {
  "w" : 2
},
"defaultReadConcern" : {
  "level" : "majority"
}

グローバルのデフォルト読み取り保証および書込み保証の解除

ユーザーは次のアクションを実行できます。

• グローバルのデフォルト読み取り保証を解除します。

• グローバルのデフォルト書込み保証をまだ設定していない場合にのみ解除できます。

たとえば、グローバルのデフォルト読み取り保証がlevel: "majority"に設定されているとします。グローバルデフォルト読み取り保証を解除するには、空のドキュメント {} を使用します。

db.adminCommand( {
   "setDefaultRWConcern" : 1,
   "defaultReadConcern" : {}
} )

この操作は、操作が成功したことを示す以下のドキュメントを返します。

{
   defaultReadConcern: { level: 'local' },
   defaultWriteConcern: { w: 2, wtimeout: 0 },
   updateOpTime: Timestamp({ t: 1656696934, i: 1 }),
   updateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   defaultWriteConcernSource: 'global',
   defaultReadConcernSource: 'implicit',
   localUpdateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   ok: 1,
   '$clusterTime': {
      ...
   },
   operationTime: Timestamp({ t: 1656632593, i: 1 })
}

グローバルのデフォルト書込み保証をまだ設定していない場合にのみ解除できます。

グローバルデフォルト書込み保証の設定を解除するには、空のドキュメント{}を使用します。

db.adminCommand( {
   "setDefaultRWConcern" : 1,
   "defaultWriteConcern" : {}
} )

グローバルのデフォルト書込み保証が次の通りである場合、

• 解除の操作は成功します。

• 既に設定されている場合、操作は次のエラーを返します。

MongoServerError: The global default write concern cannot be unset
once it is set.