checkMetadataConsistency(데이터베이스 명령)

정의

checkMetadataConsistency

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

팁

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의 소스 사용 가능 무료 자체 관리 버전

구문

• 전체 cluster의 샤딩 메타데이터 불일치를 확인하려면 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
}