getDefaultRWConcern
定義
getDefaultRWConcern
getDefaultRWConcern
管理コマンドは、グローバルなデフォルトの読み取りまたは書込み保証設定を取得します。シャーディングされたクラスターの場合は、
getDefaultRWConcern
でmongos
を発行します。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
注意
このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
コマンドの形式は次のとおりです。
db.adminCommand( { getDefaultRWConcern: 1 , inMemory: <boolean>, comment: <any> } )
コマンドフィールド
コマンドには次のフィールドがあります:
フィールド | タイプ | 説明 |
---|---|---|
整数 |
| |
ブール値 | 任意。 を 配置のグローバルなデフォルトの読み取りまたは書込み保証 (write concern) のディスク上のコピーを返すには、 を | |
comment | any | 任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。
コメントには、有効な BSON 型(string, integer, object, array など)を使用できます。 |
出力
出力には、次のフィールドが含まれる場合があります。
フィールド | タイプ | 説明 |
---|---|---|
object | グローバルなデフォルトの書込み保証 ( write concern ) の構成。 配置にグローバルなデフォルトの書込み保証 (write concern) 設定がない場合、このフィールドは | |
object | グローバルのデフォルトの読み取り保証 ( read concern ) の構成。 配置にグローバルなデフォルトの読み取り保証がない場合、このフィールドは | |
文字列 | デフォルトの書込み保証 (write concern) のソース。デフォルトでは、値は | |
文字列 | デフォルトの読み取り保証 (read concern) のソース。デフォルトでは、値は | |
タイムスタンプ | グローバルのデフォルトの読み取りまたは書込み保証 (write concern) 設定が最後に変更されたときの操作タイムスタンプ。 クラスターにデフォルトが設定されている場合は存在します。 | |
日付 | 管理者がグローバルなデフォルトの読み取りまたは書込み保証 (write concern) を最後に設定したウォール クロックの日付。 この値は情報提供であり、最新性の比較には使用しないでください。 | |
日付 |
動作
注意
FeatureCompatibilityVersion 4.4 以上が必要です。
mongod
レプリカセットまたはシャーディングされたクラスター内の各 4.4
は、getDefaultRWConcern
featureCompatibilityVersion を少なくとも に設定する 必要 があります。配置のfeatureCompatibilityVersionを4.4
から4.2
にダウングレードすると、クラスター全体のすべての読み取りおよび書込み保証 (write concern) のデフォルトはなくなりますが、 mongos
インスタンスは最大30秒デフォルトを適用し続ける可能性があります。
レプリカセット
getDefaultRWConcern
セットのデータを保持する任意のノード( アービタではない)。
セカンダリは、プライマリからの最新の変更をまだ複製していない場合、グローバル デフォルト設定の「古い」バージョンを返すことができます。
シャーディングされたクラスター
setDefaultRWConcern
クラスター内の に対してmongos
を発行します。
各mongos
は、グローバル デフォルト設定のローカル コピーを定期的に更新します。 mongos
は、グローバル デフォルト設定を最近更新した後にローカル コピーをまだ更新していない場合、または遅延したコンフィギュレーションサーバーのセカンダリから設定を取得した場合、グローバル デフォルト設定の「古い」バージョンを返すことがあります。
グローバル デフォルト設定は、個々のシャードに伝播しません。 シャードに対してgetDefaultRWConcern
を実行することはできません。
アクセス制御
自己管理型配置で認証を強制する レプリカセット または シャーディングされたクラスター の場合、 getDefaultRWConcern
には認証されたユーザーがgetDefaultRWConcern
特権アクションを持っている必要があります。
clusterManager
またはclusterMonitor
の組み込みロールが、 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) }