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

定義

checkMetadataConsistency

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

Tip

In mongosh, this command can also be run through the db.checkMetadataConsistency(), db.collection.checkMetadataConsistency(), or sh.checkMetadataConsistency() helper methods.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

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

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

バージョン7.0の新機能。

互換性

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

• MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

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

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

構文

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

  db.adminCommand( {
     checkMetadataConsistency: 1
  } )

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

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

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

  use library
  db.runCommand( {
     checkMetadataConsistency: "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
}