문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
결과 설명
이 페이지의 내용
쿼리 계획 및 쿼리 계획 의 실행 통계에 대한 정보를 반환하기 위해 MongoDB는 다음 메서드를 제공합니다.
중요한 Explain 결과 필드와 이를 해석하는 방법에 대해 알아보려면 Explain Plan 결과 해석을 참조하세요.
중요
explain 계획 캐시를 무시합니다. 대신 후보 계획 세트가 생성되고 계획 캐시를 참조하지 않고 승자가 선택됩니다. 또한 explain 은 MongoDB 쿼리 플래너가 성공적인 계획을 캐싱하는 것을 방지합니다.
참고
이 페이지에는 가장 중요한 출력 필드만 표시되며 내부용 필드는 문서화되지 않습니다. 출력에 나열된 필드는 변경될 수 있습니다.
출력 구조 설명
explain 결과는 쿼리 계획을 단계 트리로 표시합니다. 출력 구조는 작업에서 사용하는 쿼리 엔진에 따라 달라질 수 있습니다. 작업은 클래식 쿼리 엔진 또는 슬롯 기반 실행 쿼리 엔진을 사용할 수 있습니다.
두 실행 엔진 간의 출력 구조가 어떻게 다른지 확인하려면 다음 예를 참조하세요.
각 단계는 결과 문서 또는 인덱스 키를 상위 노드에 전달합니다. 리프 노드는 컬렉션 또는 인덱스에 액세스합니다. 내부 노드는 하위 노드에서 생성된 문서 또는 인덱스 키를 사용합니다. 루트 노드는 MongoDB가 궁극적으로 결과 세트를 파생하는 단계를 나타냅니다.
단계는 작업에 대한 설명입니다. 예를 들어 다음과 같습니다.
COLLSCAN컬렉션 스캔용IXSCAN인덱스 키 스캔용FETCH문서 검색용GROUP문서 그룹화용SHARD_MERGE샤드에서 결과를 병합하는 경우SHARDING_FILTER샤드에서 고아 문서를 필터링하기 위해BATCHED_DELETE내부적으로 일괄 처리되는 여러 문서를 삭제하는 경우(MongoDB 6.1부터).
MongoDB 5.1 및 이후 버전을 위한 Explain 출력
이 섹션에서는 MongoDB 5.1 이후에 대한 explain 출력을 보여 줍니다. 이전 버전의 MongoDB에 대한 출력 설명을 보려면 해당 버전의 문서를 참조하세요.
explain.explainVersion정수 필드입니다.
explainVersion"1"또는"2"와 같은 계획의 출력 형식 버전입니다.버전 5.1에 추가되었습니다.
queryPlanner
explain.queryPlanner 정보는 쿼리 옵티마이저가 선택한 계획을 자세히 설명합니다.
이러한 예시는 MongoDB의 클래식 및 슬롯 기반 실행 엔진의 출력 구조를 결합할 수 있습니다. 대표성을 갖기 위한 것이 아닙니다. 실제 출력은 크게 다를 수 있습니다.
explain.queryPlanner쿼리 최적화 프로그램에서 선택한 쿼리 계획에 대한 정보가 들어 있습니다.
explain.queryPlanner.namespace쿼리에서 액세스하는 데이터베이스 및 컬렉션의 이름이 포함된 네임스페이스를 지정하는 문자열입니다. 네임스페이스의 형식은
<database>.<collection>입니다.
explain.queryPlanner.queryHash쿼리 형태의 해시를 나타내며 쿼리 형태에만 종속되는 16진수 문자열입니다.
queryHash는 같은 쿼리 형태를 가진 느린 쿼리(쓰기 작업의 쿼리 필터 포함)를 식별하는 데 도움이 될 수 있습니다.참고
다른 해시 함수와 마찬가지로, 두 개의 다른 쿼리 형태가 동일한 해시 값을 생성할 수 있습니다. 그러나 서로 다른 쿼리 형태 간에 해시 충돌이 발생할 가능성은 거의 없습니다.
queryHash및planCacheKey에 대한 자세한 내용은queryHash및planCacheKey를 참조하십시오.
explain.queryPlanner.planCacheKey쿼리와 연관된 계획 캐시 항목에 대한 키의 해시입니다.
explain.queryPlanner.queryHash과 달리explain.queryPlanner.planCacheKey는 쿼리 형태와 해당 형태에 대해 현재 사용 가능한 인덱스 모두의 함수입니다. 즉, 쿼리 형태를 지원할 수 있는 인덱스를 추가/삭제하면planCacheKey값은 변경될 수 있지만queryHash값은 변경되지 않습니다.queryHash및planCacheKey에 대한 자세한 내용은queryHash및planCacheKey를 참조하십시오.
explain.queryPlanner.optimizedPipeline전체 집계 파이프라인 작업이 최적화되고 대신 쿼리 계획 실행 단계 트리에 의해 이행되었음을 나타내는 부울입니다.
예를 들어 MongoDB 4.2부터는 집계 파이프라인을 사용하지 않고 쿼리 계획 실행 트리에서 다음 집계 작업을 수행할 수 있습니다.
db.example.aggregate([ { $match: { someFlag: true } } ] ) 이 필드는 값이
true인 경우에만 표시되며 집계 파이프라인 작업에 대한 설명에만 적용됩니다.true인 경우 파이프라인이 최적화되었기 때문에 집계 단계 정보가 출력에 표시되지 않습니다.
explain.queryPlanner.winningPlan쿼리 최적화 프로그램에서 선택한 계획을 자세히 설명하는 문서입니다.
explain.queryPlanner.winningPlan.stage단계의 이름을 나타내는 문자열입니다.
각 단계는 해당 단계에 맞는 정보로 구성됩니다. 예를 들어,
IXSCAN단계에는 인덱스 스캔과 관련된 다른 데이터와 함께 인덱스 경계가 포함됩니다. 스테이지에 하위 스테이지가 하나 또는 여러 개 있는 경우 스테이지에는inputStage또는inputStages가 있습니다.이 필드는 작업에서 클래식 쿼리 실행 엔진을 사용한 경우 나타납니다.
explain.queryPlanner.winningPlan.inputStage상위 단계에 문서 또는 인덱스 키를 제공하는 하위 단계를 설명하는 문서입니다. 이 필드는 상위 단계에 하위 단계가 하나만 있는 경우에 표시됩니다.
explain.queryPlanner.winningPlan.inputStages하위 단계를 설명하는 문서 배열입니다. 하위 단계는 상위 단계에 문서 또는 인덱스 키를 제공합니다. 이 필드는 상위 단계에 여러 하위 노드가 있는 경우 에 표시됩니다. 예를 들어 $or 표현식 에 대한 단계는 여러 소스의 입력을 사용할 수 있습니다.
이 필드는 작업에서 클래식 쿼리 실행 엔진을 사용한 경우 나타납니다.
explain.queryPlanner.winningPlan.queryPlan쿼리 최적화 프로그램에서 선택한 계획을 자세히 설명하는 문서입니다. MongoDB는 계획을 단계별 트리로 표시합니다.
이 문서는 쿼리가 슬롯 기반 실행 쿼리 엔진을 사용한 경우에 나타납니다.
버전 5.1에 추가되었습니다.
explain.queryPlanner.winningPlan.queryPlan.stage단계의 이름을 나타내는 문자열입니다.
각 단계는 해당 단계에 맞는 정보로 구성됩니다. 예를 들어,
IXSCAN단계에는 인덱스 스캔과 관련된 다른 데이터와 함께 인덱스 경계가 포함됩니다.
explain.queryPlanner.winningPlan.queryPlan.planNodeId실행 계획의 각 단계를 식별하는 고유한 정수 필드입니다. 필드는
explain결과의 모든 단계에 포함되어 있습니다.버전 5.1에 추가되었습니다.
explain.queryPlanner.winningPlan.queryPlan.inputStage
explain.queryPlanner.winningPlan.slotBasedPlan슬롯 기반 쿼리 실행 계획 트리 및 단계에 대한 정보가 포함된 문서입니다. MongoDB 내부 사용을 위한 것입니다.
버전 5.1에 추가되었습니다.
explain.queryPlanner.rejectedPlans쿼리 최적화 프로그램에서 고려하고 거부한 후보 계획의 배열입니다. 다른 후보 계획이 없는 경우 배열은 비어 있을 수 있습니다.
executionStats
반환된 explain.executionStats 정보는 성공적인 계획의 실행을 자세히 설명합니다. 결과에 executionStats 를 포함하려면 다음 중 하나에서 explain을 실행해야 합니다.
allPlansExecution 세부 정보 표시 모드입니다.
allPlansExecution모드를 사용하여 계획 선택 중에 캡처한 부분 실행 데이터를 포함할 수 있습니다.
이러한 예시는 MongoDB의 클래식 및 슬롯 기반 실행 엔진의 출력 구조를 결합할 수 있습니다. 대표성을 갖기 위한 것이 아닙니다. 실제 출력은 크게 다를 수 있습니다.
explain.executionStats우승한 계획에 대해 완료된 쿼리 실행을 설명하는 통계가 포함됩니다. 쓰기 작업의 경우 완료된 쿼리 실행은 수행될 수정을 의미하지만 데이터베이스에 수정 사항을 적용하지는 않습니다.
explain.executionStats.nReturned성공적인 쿼리 계획에서 반환된 문서 수입니다.
nReturned는 이전 버전의 MongoDB에서cursor.explain()가 반환한n필드에 해당합니다.
explain.executionStats.executionTimeMillis쿼리 계획 선택과 쿼리 실행에 필요한 총 시간(밀리초 단위)입니다. 여기에는 계획 선택 프로세스의 시험 단계를 실행하는 데 걸리는 시간을 포함하지만, 클라이언트로 데이터를 전송하는 데 걸리는 네트워크 시간은 포함하지 않습니다.
explain.executionStats.executionTimeMillis에서 보고한 시간이 반드시 실제 쿼리 시간을 나타내는 것은 아닙니다. 정상 상태 작업 중(쿼리 계획이 캐시된 경우) 또는cursor.hint()을cursor.explain()와 함께 사용하는 경우, MongoDB는 계획 선택 프로세스를 우회하여 실제 시간을 단축하므로explain.executionStats.executionTimeMillis값이 더 낮아집니다.
explain.executionStats.totalKeysExamined스캔된 인덱스 항목 수입니다.
explain.executionStats.totalKeysExamined는 이전 버전의 MongoDB에서cursor.explain()가 반환한nscanned필드에 해당합니다.
explain.executionStats.totalDocsExamined쿼리 실행 중에 검토한 문서 수입니다. 문서를 검사하는 일반적인 쿼리 실행 단계는
COLLSCAN및FETCH입니다.참고
explain.executionStats.totalDocsExamined는 반환된 문서 수가 아니라 검사된 총 문서 수를 나타냅니다. 예를 들어, 스테이지에서는 필터를 적용하기 위해 문서를 검사할 수 있습니다. 문서가 필터링되면 문서가 검사되었지만 쿼리 결과 집합의 일부로 반환되지 않습니다.쿼리 실행 중에 문서를 여러 번 검사하는 경우
explain.executionStats.totalDocsExamined은 각 검사 횟수를 계산합니다. 즉,explain.executionStats.totalDocsExamined는 검사한 총 고유 문서 수를 계산한 것이 아닙니다 .
explain.executionStats.executionStages성공적인 계획의 완료된 실행을 단계 트리로 자세히 설명합니다. 즉, 단계는 하나의
inputStage또는 여러 개의inputStages를 가질 수 있습니다.MongoDB 5.1부터 단계에 다음과 같은 입력 단계를 가질 수 있습니다.
thenStageelseStageinnerStageouterStage
각 단계는 단계와 관련된 실행 정보로 구성됩니다.
explain.executionStats.executionStages.executionTimeMillisEstimate쿼리 실행에 대한 예상 시간(밀리초)입니다.
explain.executionStats.executionStages.opensMongoDB 5.1부터 쿼리 실행 중에 단계가 열린 횟수입니다.
explain.executionStats.executionStages.closesMongoDB 5.1부터 쿼리 실행 중에 단계가 닫힌 횟수입니다.
explain.executionStats.executionStages.works쿼리 실행 단계에서 수행되는 "작업 단위" 수를 지정합니다. 쿼리 실행은 작업을 작은 단위로 나눕니다. "작업 단위"는 단일 인덱스 키를 검사하거나, 컬렉션에서 단일 문서를 가져오거나, 단일 문서에 프로젝션을 적용하거나, 내부 회계 작업을 수행하는 것으로 구성될 수 있습니다.
이 필드는 작업에서 클래식 쿼리 실행 엔진을 사용한 경우 나타납니다.
explain.executionStats.executionStages.saveState쿼리 단계에서 처리를 일시 중단하고 현재 실행 상태를 저장한 횟수입니다(예시: 잠금 양보를 위한 준비).
explain.executionStats.executionStages.restoreState쿼리 단계에서 저장된 실행 상태를 복원한 횟수입니다(예시: 이전에 생성된 잠금을 복구한 후).
explain.executionStats.executionStages.isEOF실행 단계가 스트림 종료에 도달했는지 여부를 지정합니다.
true또는1이면 실행 단계가 스트림 종료에 도달한 것입니다.false또는0인 경우 단계에 반환할 결과가 남아있을 수 있습니다. 예를 들어 실행 단계가 쿼리의 입력 단계가IXSCAN인LIMIT단계로 구성된 제한이 있는 쿼리를 가정해 보겠습니다. 쿼리가 지정된 제한보다 많은 값을 반환하는 경우LIMIT단계는isEOF: 1을 보고하지만 기본IXSCAN단계는isEOF: 0을 보고합니다.
explain.executionStats.executionStages.inputStage각
inputStage는inputStage.stage의 값에 따라 다른 필드를 가질 수 있습니다. 다음 표에서는 가능한 필드와 해당 필드가 표시될 수 있는 단계에 대해 설명합니다.각
inputStage는 다른inputStage을 필드로 가질 수 있습니다. 출력 구조 설명을 참조하세요.필드설명적용 가능한 단계docsExamined쿼리 실행 단계에서 스캔되는 문서 수를 지정합니다.COLLSCAN,FETCHkeysExamined쿼리 실행 단계에서 인덱스keysExamined는 인덱스 스캔 프로세스에서 검사되는 내부 및 범위를 벗어난 키의 총 수입니다. 인덱스 스캔이 단일 연속 키 범위로 구성된 경우 인바운드 키만 검사하면 됩니다. 인덱스 경계가 여러 키 범위로 구성된 경우 인덱스 스캔 실행 프로세스에서 범위를 벗어난 키를 검사하여 한 범위의 끝에서 다음 범위의 시작으로 건너뛸 수 있습니다.IXSCANnumReads쿼리 실행 단계에서 검사된 문서 수 또는 검사된 인덱스 키 수입니다.
버전 5.1에 추가되었습니다.
COLLSCAN,IXSCANseeks인덱스 스캔을 완료하기 위해 인덱스 커서를 새 위치로 이동해야 했던 횟수입니다.IXSCANspilledBytesApprox해당 단계에서 디스크로 유출된 메모리 내 바이트의 대략적인 수입니다.
버전 5.3에 추가.
GROUPspilledRecords해당 단계에서 디스크로 유출된 생성된 레코드 수입니다.
버전 5.3에 추가.
GROUPusedDisk해당 단계가 디스크를 썼는지 여부입니다.
버전 5.3에 추가.
GROUP
explain.executionStats.allPlansExecution채택된 계획과 거부된 계획 모두에 대해 계획 선택 단계에서 캡처한 부분 실행 정보를 포함합니다. 이 필드는
explain가allPlansExecution세부 정보 표시 모드에서 실행되는 경우에만 표시됩니다.
explain.executionStats.operationMetrics0이 아닌 한 리소스 소비 통계를 포함합니다. 이 필드는
explain가executionStats상세도 모드 이상에서 실행되고profileOperationResourceConsumptionMetrics가 활성화된 경우에만 표시됩니다.
serverInfo
파이프라인 단계가 $lookup 인 쿼리에 대한 실행 계획 통계
버전 5.0에 추가.
설명 결과 에는 $lookup 파이프라인 단계를 사용하는 쿼리에 대한 실행 통계가 포함될 수 있습니다. 이러한 실행 통계를 포함하려면 다음 실행 상세도 모드 중 하나로 설명 작업을 실행해야 합니다.
다음 필드는 $lookup 쿼리에 대한 Explain 결과에 포함됩니다.
'$lookup': { from: <string>, as: <string>, localField: <string>, foreignField: <string> }, totalDocsExamined: <long>, totalKeysExamined: <long>, collectionScans: <long>, indexesUsed: [ <string_1>, <string_2>, ..., <string_n> ], executionTimeMillisEstimate: <long>
$lookup 섹션의 필드에 대한 설명을 보려면 $lookup 페이지를 참조하십시오.
다른 필드는 다음과 같습니다.
explain.totalDocsExamined쿼리 실행 중에 검사한 문서 수입니다.
explain.totalKeysExamined검사한 인덱스 키의 수입니다.
explain.collectionScans쿼리 실행 중에 컬렉션 검색이 발생한 횟수입니다. 컬렉션 검색 중에 컬렉션의 각 문서는 쿼리 조건자와 비교됩니다. 쿼리를 커버하는 적절한 인덱스가 없는 경우 컬렉션 스캔이 수행됩니다.
explain.indexesUsed쿼리에서 사용하는 인덱스의 이름이 있는 문자열 배열입니다.
explain.executionTimeMillisEstimate쿼리 실행에 소요될 것으로 예상되는 시간(밀리초)입니다.
컬렉션 스캔
쿼리 플래너가 컬렉션 검색을 선택하면 설명 결과에 COLLSCAN 단계가 포함됩니다.
쿼리 플래너가 인덱스를 선택하면 explain 결과에 IXSCAN 단계가 포함됩니다. 이 단계에는 인덱스 키 패턴, 순회 방향, 인덱스 범위 등의 정보가 포함됩니다.
MongoDB 부터 5 시작.3 쿼리 플래너가 클러스터형 컬렉션 에 대한 클러스터형 인덱스 를 선택하고 쿼리에 검색할 인덱스 부분을 정의하는 경계가 포함되어 있는 경우 설명 결과에 단계가 CLUSTERED_IXSCAN 포함됩니다. 이 단계에는 클러스터형 인덱스 키 및 인덱스 바운드에 대한 정보가 포함됩니다.
쿼리 플래너가 클러스터형 컬렉션 에 대해 클러스터형 인덱스 를 선택하고 쿼리에 경계가 포함되어 있지 않은 경우 쿼리는 바인딩되지 않은 컬렉션 스캔을 수행하고 설명 결과에는 단계가 COLLSCAN 포함됩니다.
참고
쿼리에는 전체 컬렉션 스캔이 필요하므로 notablescan 매개 변수는 클러스터형 인덱스를 사용하는 바인딩되지 않은 쿼리를 허용하지 않습니다.
collection 스캔의 실행 통계에 대한 자세한 내용은 설명 계획 결과 해석을 참조하세요.
지원되는 쿼리
인덱스가 쿼리를 포함하는 경우, MongoDB는 쿼리 조건을 일치시키고 인덱스 키만을 사용하여 결과를 반환할 수 있습니다. MongoDB는 결과를 반환하기 위해 컬렉션의 문서를 검사할 필요가 없습니다.
인덱스가 쿼리를 포함하는 경우 설명 결과에는 FETCH 단계의 하위 항목이 아닌 IXSCAN 단계가 있으며 executionStats 에서 explain.executionStats.totalDocsExamined 는 0 입니다.
$or 표현식
MongoDB가 $or 표현식에 인덱스를 사용하는 경우 결과에는 인덱스를 자세히 설명하는 explain.queryPlanner.winningPlan.inputStages 배열이 있는 OR 단계가 포함됩니다. 예:
{ stage: 'OR', inputStages: [ { stage: 'IXSCAN', ... }, { stage : 'IXSCAN', ... }, ... ] }
이전 버전의 MongoDB에서는 cursor.explain() 색인을 자세히 설명하는 clauses 배열을 반환했습니다.
$sort 및 $group 단계
explain이 executionStats 또는 allPlansExecution 세부 정보 표시 모드에서 실행되면 $sort 및 $group 단계에 추가 출력이 있습니다.
단계 | 필드 | 유형 | 설명 |
|---|---|---|---|
totalDataSizeSortedBytesEstimate | long | $sort 단계에서 처리된 예상 바이트 수입니다. | |
usedDisk | 부울 | $sort 단계에서 디스크에 기록했는지 여부입니다. | |
totalOutputDataSizeBytes | long | $group 단계에서 출력된 모든 문서의 총 크기(바이트)에 대한 추정치입니다. | |
usedDisk | 부울 | $group 단계에서 디스크에 기록했는지 여부입니다. | |
spillFileSizeBytes | long | $group 단계에서 디스크에 기록된 유출 파일의 크기입니다. 압축으로 인해 spillFileSizeBytes 값은 numBytesSpilledEstimate보다 작거나 같아야 합니다. | |
numBytesSpilledEstimate | long | 압축 전 $group 단계에서 디스크에 기록된 바이트 수의 추정치입니다. |
정렬 단계
MongoDB가 하나 이상의 인덱스를 사용하여 정렬 순서를 가져올 수 없는 경우 결과에는 차단 정렬 작업을 나타내는 SORT 단계가 포함됩니다. 차단 정렬은 컬렉션이나 데이터베이스에서 동시 작업을 차단하지 않습니다. 이름은 SORT 가 출력 문서를 반환하기 전에 모든 입력 문서를 읽어 해당 특정 쿼리에 대한 데이터 흐름을 차단해야 한다는 요구 사항을 나타냅니다.
블로킹 정렬 작업에 메가바이트 이상의 시스템 메모리를 사용해야 100 하는 경우 쿼리에 을(를) 지정 하지 않는 한 MongoDB는 오류를 cursor.allowDiskUse() 반환합니다. 는cursor.allowDiskUse() MongoDB가 블로킹 정렬 작업을 처리하는 동안 디스크의 임시 파일을 사용하여 메가바이트 시스템 메모리 제한을 초과하는 데이터를 저장할 수 100 있도록 허용합니다. 설명 계획에 명시적인 단계가 포함되어 있지 SORT 않으면 MongoDB는 인덱스를 사용하여 정렬 순서를 얻을 수 있습니다.