sh.checkMetadataConsistency()（mongoshメソッド）

定義

sh.checkMetadataConsistency(options)

クラスターのシャーディングメタデータの整合性に関して一連のチェックを実行します。このメソッドは、不整合の結果のすべてまたはバッチが見つかったカーソルを返します。

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

データベースコマンドについては、checkMetadataConsistency コマンドを参照してください。

MongoDB API ドライバーについては、各言語の MongoDB ドライバードキュメントを参照してください。

アップグレードやダウングレードなどの主要なメンテナンス操作の後にこのメソッドを実行し、MongoDB の以前のリリースのバグが原因でクラスターメタデータが一貫していないか、破損していないかどうかを確認します。

デフォルトでは、メソッドはシャード間での整合性についてインデックスをチェックしません。インデックスチェックは、インデックスを作成、削除、または変更する操作と同時に実行されると、誤検知の不整合を返す可能性があります。この方法でインデックスを確認するには、 checkIndexesオプションを設定します。

このメソッドがチェックする不整合について詳しくは、「不整合のタイプ」を参照してください。

次の値を返します。	このメソッドは、シャーディングメタデータで見つかった各不整合に対応するドキュメントを含む`documents`配列を持つカーソルを返します。

互換性

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

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、「サポートされていないコマンド」を参照してください。

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

注意

checkMetadataConsistencyヘルパーは、mongos に接続しているときにのみ実行できます。 mongod はこのメソッドをサポートしていません。

構文

sh.checkMetadataConsistency()メソッドの構文は次のとおりです。

sh.checkMetadataConsistency( { <options> } )

optionsドキュメントは、次のフィールドと値を取ることができます。

フィールド	タイプ	説明
`checkIndexes`	ブール値	コマンドがシャーディングメタデータのインデックスもチェックするかどうかを設定します。デフォルトでは、この操作は無効になっています。これは、インデックスを作成、削除、または変更する操作と同時に実行されると、誤検知によって不整合が返される可能性があるためです。これらの操作が発生する可能性が低いことがわかっている場合にのみ、インデックスをチェックしてください。
`cursor`	ドキュメント	リターンカーソルを構成します。
`cursor.batchSize`	integer	各バッチに含めるシャーディングメタデータの不整合ドキュメントの最大数。

例

sh.checkMetadataConsistency()

{
   cursorHasMore: false,
   documents: [
      {
         type: "MisplacedCollection",
         description: "Unsharded collection found on shard different from database primary shard",
         details: {
            namespace: "test.authors",
            shard: "shard02",
            localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4")
         }
      }
   ],
}

戻る

sh. balancerCollectionStatus

sh.commitReshardCollection