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

定義

getDefaultRWConcern

The getDefaultRWConcern administrative command retrieves the global default read or write concern settings.

For sharded clusters, issue the getDefaultRWConcern on a mongos.

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

注意

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

コマンドの形式は次のとおりです。

db.adminCommand(
   {
     getDefaultRWConcern: 1 ,
     inMemory: <boolean>,
     comment: <any>
   }
)

コマンドフィールド

コマンドには次のフィールドがあります:

フィールド	タイプ	説明
getDefaultRWConcern	整数	`1` に設定します。
インメモリ	ブール値	任意。を`true`に設定すると、グローバルなデフォルトの読み取りまたは書込み保証 (write concern) 設定のメモリ内キャッシュされたコピーが返されます。インスタンスは、操作にグローバルデフォルトを適用するときに、メモリ内コピーを使用します。配置のグローバルなデフォルトの読み取りまたは書込み保証 (write concern) のディスク上のコピーを返すには、を`false`に設定します。デフォルトは`false`です。
`comment`	any	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

出力

出力には、次のフィールドが含まれる場合があります。

フィールド	タイプ	説明
defaultWriteConcern	`object`	グローバルなデフォルトの書込み保証 ( write concern ) の構成。配置にグローバルなデフォルトの書込み保証 (write concern) 設定がない場合、このフィールドは`getDefaultRWConcern`の出力から存在しません。
defaultReadConcern	`object`	グローバルのデフォルトの読み取り保証 ( read concern ) の構成。配置にグローバルなデフォルトの読み取り保証がない場合、このフィールドは`getDefaultRWConcern`の出力から存在しません。
defaultWriteConcernSource	文字列	デフォルトの書込み保証 (write concern) のソース。デフォルトでは、値は`"implicit"`です。デフォルトの書込み保証 (write concern) を`setDefaultRWConcern`に設定すると、値は`"global"`になります。
defaultReadConcernSource	文字列	デフォルトの読み取り保証 (read concern) のソース。デフォルトでは、値は`"implicit"`です。デフォルトの読み取り保証 (read concern) を`setDefaultRWConcern`に設定すると、値は`"global"`になります。
updateOpTime	タイムスタンプ	グローバルのデフォルトの読み取りまたは書込み保証 (write concern) 設定が最後に変更されたときの操作タイムスタンプ。クラスターにデフォルトが設定されている場合は存在します。
updateWalClockTime	日付	管理者がグローバルなデフォルトの読み取りまたは書込み保証 (write concern) を最後に設定したウォールクロックの日付。この値は情報提供であり、最新性の比較には使用しないでください。
localUpdateWalClockTime	日付	`mongod`または`mongos`がグローバルなデフォルトの読み取り保証および書込み保証のローカルコピーを最後に更新したウォールクロックの日付。この値は情報提供であり、最新性の比較には使用しないでください。

Tip

setDefaultRWConcern

動作

注意

FeatureCompatibilityVersion 4.4 以上が必要です。

Each mongod in the replica set or sharded cluster must have featureCompatibilityVersion set to at least 4.4 to use getDefaultRWConcern. If you downgrade your deployment's featureCompatibilityVersion from 4.4 to 4.2, all cluster-wide read and write concern defaults are lost, but mongos instances may continue applying the defaults for up to 30 seconds.

レプリカセット

You can issue getDefaultRWConcern against any data-bearing member of the replica set (i.e. not against an arbiter).

セカンダリは、プライマリからの最新の変更をまだ複製していない場合、グローバルデフォルト設定の「古い」バージョンを返すことができます。

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

setDefaultRWConcernクラスター内のに対してmongos を発行します。

各mongosは、グローバルデフォルト設定のローカルコピーを定期的に更新します。 mongosは、グローバルデフォルト設定を最近更新した後にローカルコピーをまだ更新していない場合、または遅延したコンフィギュレーションサーバーのセカンダリから設定を取得した場合、グローバルデフォルト設定の「古い」バージョンを返すことがあります。

The global default settings do not propagate to the individual shards. You cannot run getDefaultRWConcern against a shard.

アクセス制御

For replica sets or sharded clusters enforcing Authentication on Self-Managed Deployments, getDefaultRWConcern requires that the authenticated user have the getDefaultRWConcern privilege action.

The clusterManager or clusterMonitor built-in roles provides the required privileges to run getDefaultRWConcern.

例

次の操作は、 mongodに対して現在構成されているグローバルのデフォルトの読み取りおよび書込み保証を取得します。

db.adminCommand({
  "getDefaultRWConcern": 1
})

この操作は、次のような出力を返します。

{
  "defaultWriteConcern" : {
    "w" : "majority"
  },
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "defaultWriteConcernSource" : "global",
  "defaultReadConcernSource" : "global",
  "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)
}

戻る

getClusterParameter

getParameter