설명합니다.

정의

explain

explain 명령은 aggregate, count, distinct, find, findAndModify, delete, mapReduce 명령의 실행에 대한 정보를 제공합니다. update.

팁

mongosh에서 이 명령은 db.collection.explain() 및 cursor.explain() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

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

explain 명령의 구문은 다음과 같습니다.

{
   explain: <command>,
   verbosity: <string>,
   comment: <any>
}

이 명령은 다음 필드를 사용합니다.

필드	유형	설명
explain	문서	실행 정보를 반환할 명령을 지정하는 문서입니다. 특정 명령 문서에 대한 자세한 내용은 aggregate, count, distinct, find, findAndModify, delete, mapReduce및 update를 참조하세요.
verbosity	문자열	선택 사항입니다. explain을 실행할 모드를 지정하는 문자열입니다. 이 모드는 explain의 동작에 영향을 미치고 반환할 정보의 양을 결정합니다. 가능한 모드는 다음과 같습니다. "queryPlanner" "executionStats" "allPlansExecution" (기본값) 모드에 대한 자세한 내용은 동작 설명을참조하세요.
comment	어떤	선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다. mongod 로그 메시지( attr.command.cursor.comment 필드). 데이터베이스 프로파일러 출력의 command.comment 필드에 있습니다. currentOp{command.comment 5} 필드에 출력을 입력합니다. 댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. 참고 comment 없이 explain을 지정하면 explain에 지정된 명령의 모든 comment를 상속합니다.

행동

출력

explain 작업은 다음과 관련된 정보를 반환할 수 있습니다.

• explainVersion출력 형식 버전(예: "1"),

• command설명 중인 명령에 대한 자세한 정보를 제공합니다.

• queryPlanner는 쿼리 옵티마이저가 선택한 계획을 설명하고 거부된 계획을 나열하고,

• executionStats성공적인 계획과 거부된 계획의 실행을 자세히 설명하고,

• serverInfoMongoDB 인스턴스에 대한 정보를 제공하는 [serverInfo]

• serverParameters내부 매개변수를 자세히 설명합니다.

다변성 모드(예: queryPlanner, executionStats, allPlansExecution)는 결과에 executionStats를 포함되는지 여부와 executionStats에 요금제 선택 중 캡처한 데이터가 포함되는지 여부를 결정합니다.

출력에 대한 자세한 내용은 Explain 결과 항목을 참조하세요.

예제

db.runCommand(
   {
     explain: { count: "products", query: { quantity: { $gt: 50 } } },
     verbosity: "queryPlanner"
   }
)

db.runCommand(
   {
      explain: { count: "products", query: { quantity: { $gt: 50 } } },
      verbosity: "executionStats"
   }
)

db.runCommand(
   {
     explain: {
        update: "products",
        updates: [
           {
               q: { quantity: 1057, category: "apparel" },
               u: { $set: { reorder: true } }
           }
        ]
     }
   }
)