checkMetadataConsistency

정의

checkMetadataConsistency

cluster, 데이터베이스 또는 collection의 샤딩 메타데이터에 대한 일련의 일관성 검사를 수행합니다. 이 명령은 발견된 불일치 결과 전체 또는 배치가 포함된 커서를 반환합니다.

팁

mongosh 에서 이 명령은 db.checkMetadataConsistency(), db.collection.checkMetadataConsistency() 또는 sh.checkMetadataConsistency() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

헬퍼 메서드는 mongosh 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.

업그레이드 및 다운그레이드와 같은 주요 유지 관리 작업 후에 이 명령을 실행하여 카탈로그의 상태를 확인하세요.

기본적으로 이 명령은 샤드 전체에서 일관성을 위해 인덱스를 확인하지 않습니다. 인덱스를 확인하려면 checkIndexes 옵션을 설정합니다.

버전 7.0에 추가.

호환성

이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

• 전체 cluster의 샤딩 메타데이터 불일치를 확인하려면 admin 데이터베이스에서 명령을 실행합니다.

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

• 데이터베이스에서 샤딩 메타데이터 불일치를 확인하려면 데이터베이스 컨텍스트에서 명령을 실행합니다.

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

• collection에 샤딩 메타데이터 불일치가 있는지 확인하려면 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
}