checkpointMetadataConsistency

定義

checkMetadataConsistency

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

Tip

mongoshでは、このコマンドは db.checkMetadataConsistency() 、 db.collection.checkMetadataConsistency() 、またはsh.checkMetadataConsistency()ヘルパー メソッド を通じて実行することもできます。

ヘルパー メソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。 便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、 データベースコマンドを使用します。

アップグレードやダウングレードなどの主要なメンテナンス操作の後にこのコマンドを実行し、カタログの状態を確認します。

デフォルトでは、 コマンドはシャード間での整合性についてインデックスをチェックしません。 インデックスを確認するには、 checkIndexesオプションを設定します。

バージョン 7.0 で追加。

互換性

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

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

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

• クラスター全体でシャーディング メタデータの不整合を確認するには、 adminデータベースから コマンドを実行します。

  db.getSiblingDB("admin").runCommand( {
     checkMetadataConsistency: 1
  } )

• データベースでシャーディング メタデータの不整合を確認するには、 データベース コンテキスト から コマンドを実行します。

  use cars
  db.runCommand( {
     checkMetadataConsistency: 1
  } )

• シャーディング メタデータの不整合がコレクションを確認するには、 collオプションを指定して コマンドを実行します。

  use library
  db.runCommand( {
     checkMetadataConsistency: 1,
     coll: "authors",
  } )

動作

var cur = db.runCommand( {
   checkMetadataConsistency: 1,
   cursor: {
      batchSize: 10
   }
} )

db.runCommand( {
   checkMetadataConsistency: 1,
   checkIndexes: true
} )

例

runCommand()を使用してcheckMetadataConsistencyコマンドを実行します。

db.runCommand( { checkMetadataConsistency: 1 } )

出力例:

{
   cursor: {
      id: Long("0"),
      ns: "test.$cmd.aggregate",
      firstBatch: [
         {
            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")
            }
         }
      ],
   },
   ok: 1
}