setDefaultRWConcern（データベースコマンド）

レプリカセット

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

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

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

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

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

アプリケーションが読み取りまたは書込み保証を明示的に指定せずに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.