db.collection.explain()

상세도 모드

db.collection.explain()의 동작과 반환되는 정보의 양은 verbosity 모드에 따라 달라집니다.

설명 및 쓰기 작업

쓰기 작업의 경우 db.collection.explain()은 수행될 쓰기 작업에 대한 정보를 반환하지만 실제로 데이터베이스를 수정하지는 않습니다.

제한 사항

$out 단계가 포함된 aggregation pipeline에 대해 executionStats 모드 또는 allPlansExecution 모드에서 explain명령/db.collection.explain()을 실행할 수 없습니다. 대신 다음 중 하나를 실행할 수 있습니다.

• queryPlanner 모드에서 설명 실행 또는

• executionStats 모드 또는 allPlansExecution 모드에서 설명을 실행하되 $out 단계 없이 실행하여 $out 이전의 단계에 대한 정보를 반환합니다.

explain() 메커니즘

db.collection.explain() 메서드는 explain 명령을 래핑하며 explain을 실행하는 데 선호되는 방법입니다.

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().aggregate()는 db.collection.aggregate() 메서드에 설명 옵션을 전달하는 것과 같습니다.

help()

db.collection.explain()에서 지원하는 작업 목록을 보려면 다음을 실행합니다.

db.collection.explain().help()

db.collection.explain().find()는 쿼리 수정자를 연결할 수 있는 커서를 반환합니다. db.collection.explain().find()에서 지원되는 쿼리 수정자 목록과 커서 관련 메서드를 보려면 다음을 실행합니다.

db.collection.explain().find().help()

여러 개의 수정자를 db.collection.explain().find()에 연결할 수 있습니다. 예를 들어 수정자를 사용한 find() 설명을 참조하세요.

queryPlanner 모드

기본적으로 db.collection.explain()은 "queryPlanner" 다변성 모드에서 실행됩니다.

다음 예시에서는 "queryPlanner" 상세도 모드에서 db.collection.explain()을 실행하여 지정된 count() 작업에 대한 쿼리 계획 정보를 반환합니다.

db.products.explain().count( { quantity: { $gt: 50 } } )

executionStats 모드

다음 예시에서는 "executionStats" 상세도 모드에서 db.collection.explain()을 실행하여 지정된 find() 작업에 대한 쿼리 계획 및 실행 정보를 반환합니다.

db.products.explain("executionStats").find(
   { quantity: { $gt: 50 }, category: "apparel" }
)

allPlansExecution 모드

다음 예시는 "allPlansExecution" 상세 모드에서 db.collection.explain()을 실행합니다. db.collection.explain()은 지정된 findAndModify() 작업에 고려된 모든 계획에 대한 queryPlanner 및 executionStats를 반환합니다.

db.products.explain( "allPlansExecution" ).findAndModify( {
   query: { name: "Tom", state: "active", rating: { $gt: 10 } },
   sort: { rating: 1 },
   update: { $inc: { score: 1 } }
} )

수정자를 find() 사용하여 설명

db.collection.explain().find() 구문을 사용하면 쿼리 수정자를 연결할 수 있습니다. 예를 들어 다음 연산은 sort() 및 hint() 쿼리 수정자가 있는 find() 메서드에 대한 정보를 제공합니다.

db.products.explain("executionStats").find(
   { quantity: { $gt: 50 }, category: "apparel" }
).sort( { quantity: -1 } ).hint( { category: 1, quantity: -1 } )

사용 가능한 쿼리 수정자 목록을 보려면 mongosh에서 다음을 실행하세요.

db.collection.explain().find().help()

explain().find() 반환 커서 반복

db.collection.explain().find()는 설명 결과로 커서를 반환합니다. mongosh에서 대화형으로 실행하는 경우 mongosh는 .next() 메서드를 사용하여 커서를 자동으로 반복합니다. 그러나 스크립트의 경우 결과를 반환하려면 .next()(또는 그 별칭 .finish())를 명시적으로 호출해야 합니다.

var explainResult = db.products.explain().find( { category: "apparel" } ).next();