cursor.explain()
정의
cursor.explain(verbosity)
중요
Mongo쉬 방법
이는
mongosh
메서드입니다. 이는Node.js
또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .대부분의 경우
mongosh
메서드는 레거시mongo
셸 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는mongosh
에서 사용할 수 없습니다.레거시
mongo
셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 문서를 참조하세요.
db.collection.find()
메서드에 대한 쿼리 계획에 대한 정보를 제공합니다.explain()
메서드의 형식은 다음과 같습니다.db.collection.find().explain() explain()
메서드에는 다음과 같은 매개변수가 있습니다.매개 변수유형설명verbose
문자열선택 사항. 설명 출력의 상세도 모드를 지정합니다. 모드는
explain()
의 동작에 영향을 미치고 반환할 정보의 양을 결정합니다. 가능한 모드는"queryPlanner"
,"executionStats"
,"allPlansExecution"
입니다.기본 모드는
"queryPlanner"
입니다.cursor.explain()
의 이전 버전과의 하위 호환성을 위해 MongoDB는true
를"allPlansExecution"
로,false
를"queryPlanner"
로 해석합니다.자세한 내용은 상세도 모드에서 확인하세요.
explain()
메서드는 쿼리 계획이 포함된 문서와 실행 통계(선택 사항)를 반환합니다.
행동
상세도 모드
cursor.explain()
의 동작과 반환되는 정보의 양은 verbosity
모드에 따라 달라집니다.
queryPlanner
모드
기본적으로 cursor.explain()
은 queryPlanner
다변성 모드에서 실행됩니다.
MongoDB는 쿼리 옵티마이저를 실행하여 평가 중인 작업에 가장 적합한 계획을 선택합니다. cursor.explain()
은 평가된 메서드에 대한 queryPlanner
정보를 반환합니다.
executionStats
모드
MongoDB는 쿼리 옵티마이저를 실행하여 성공적인 계획을 선택하고, 성공적인 계획을 완료할 때까지 실행하고, 성공적인 계획의 실행을 설명하는 통계를 반환합니다.
cursor.explain()
은 평가된 메서드에 대한 queryPlanner
및 executionStats
정보를 반환합니다. 그러나 executionStats
는 거부된 계획에 대한 쿼리 실행 정보는 제공하지 않습니다.
allPlansExecution
모드
MongoDB는 쿼리 옵티마이저를 실행하여 가장 적합한 계획을 선택하고 이를 실행하여 완료합니다. "allPlansExecution"
모드에서 MongoDB는 계획 선택 중에 캡처된 다른 후보 계획에 관한 통계뿐만 아니라 가장 적합한 계획의 실행을 설명하는 통계를 반환합니다.
cursor.explain()
은 평가된 메서드에 대한 queryPlanner
및 executionStats
정보를 반환합니다. executionStats
에는 성공 계획의 완료된 쿼리 실행 정보가 포함됩니다.
쿼리 옵티마이저가 둘 이상의 계획을 고려한 경우, executionStats
정보에는 채택된 계획과 거부된 후보 계획 모두에 관하여 계획 선택 단계에서 캡처된 부분 실행 정보도 포함됩니다.
db.collection.explain().find()
db.collection.explain().find()
(은)는 db.collection.find().explain()
(과)와 유사하지만, 다음과 같은 주요 차이점이 있습니다.
db.collection.explain().find()
구문을 사용하면 쿼리 수정자를 추가로 연결할 수 있습니다. 쿼리 수정자 목록은 db.collection.explain().find().help()를 참조하세요.db.collection.find().explain()
은 커서를 반환하며.next()
또는 그 별칭인.finish()
를 호출해야explain()
결과를 반환할 수 있습니다.mongosh
에서 대화형으로 실행하면mongosh
는 자동으로.finish()
를 호출하여 결과를 반환합니다. 그러나 스크립트의 경우 결과를 반환하려면.next()
또는.finish()
를 명시적으로 호출해야 합니다. 커서 관련 메서드 목록은 db.collection.explain().find().help() 를 참조하세요.
자세한 내용은 db.collection.explain()
을 참조하세요.
출력
cursor.explain()
작업은 다음과 관련된 정보를 반환할 수 있습니다.
explainVersion
출력 형식 버전(예:"1"
),command
설명 중인 명령에 대한 자세한 정보를 제공합니다.queryPlanner
는 쿼리 옵티마이저가 선택한 계획을 설명하고 거부된 계획을 나열하고,executionStats
성공적인 계획과 거부된 계획의 실행을 자세히 설명하고,serverInfo
MongoDB 인스턴스에 대한 정보를 제공하는 [serverInfo]serverParameters
내부 매개변수를 자세히 설명합니다.
다변성 모드(예: queryPlanner
, executionStats
, allPlansExecution
)는 결과에 executionStats
를 포함되는지 여부와 executionStats
에 요금제 선택 중 캡처한 데이터가 포함되는지 여부를 결정합니다.
출력에 대한 자세한 내용은 Explain 결과 항목을 참조하세요.
예제
다음 예시에서는 'executionStats' 상세도 모드에서 cursor.explain()
을 실행하여 지정된 db.collection.find()
작업에 대한 쿼리 계획 및 실행 정보를 반환합니다.
db.products.find( { quantity: { $gt: 50 }, category: "apparel" } ).explain("executionStats")