Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
데이터베이스 명령
/
쿼리 계획 캐시

planCacheClear

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 명령 필드
  • 필요한 액세스 권한
  • 예시

정의

planCacheClear

컬렉션 에 대해 캐시된 쿼리 계획을 제거합니다. 해당 형태에 대해 캐시된 쿼리 계획을 제거 하려면 쿼리 형태 를 지정합니다. 쿼리 형태 를 생략하여 캐시된 쿼리 계획을 모두 지웁니다.

팁

mongosh 에서 이 명령은 PlanCache.clear() 및 PlanCache.clearPlansByQuery() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

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

호환성

이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

중요

이 명령은 M0, M2 및 M5 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

구문

명령은 다음과 같은 구문을 가집니다:

db.runCommand(
   {
      planCacheClear: <collection>,
      query: <query>,
      sort: <sort>,
      projection: <projection>,
      comment: <any>
   }
)

명령 필드

이 명령은 다음과 같은 선택적 필드를 사용합니다.

필드
유형
설명
query
문서
선택 사항. 쿼리 형태 의 쿼리 조건자입니다. 필드 이름을 포함한 술어의 구조만이 형태에 중요합니다. 쿼리 조건자의 값이 중요하지 않습니다.
projection
문서
sort
문서
comment
any

선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.

댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

캐시된 쿼리 계획이 있는 쿼리 형태를 확인하려면 쿼리 형태 목록을 참조하세요.

필요한 액세스 권한

authorization(으)로 실행되는 시스템에서 사용자는 planCacheWrite 조치를 포함하는 액세스 권한이 있어야 합니다.

예시

쿼리 형태에 대해 캐시된 계획 지우기

collection orders 의 쿼리 형태가 다음과 같은 경우:

{
  "query" : { "qty" : { "$gt" : 10 } },
  "sort" : { "ord_date" : 1 },
  "projection" : { },
  "queryHash" : "9AAD95BE"
}

다음 작업은 형태에 대해 캐시된 쿼리 계획을 지웁니다.

db.runCommand(
   {
      planCacheClear: "orders",
      query: { "qty" : { "$gt" : 10 } },
      sort: { "ord_date" : 1 }
   }
)

collection에 대해 캐시된 모든 계획 지우기

다음 예에서는 orders collection에 대해 캐시된 모든 쿼리 계획을 지웁니다.

db.runCommand(
   {
      planCacheClear: "orders"
   }
)

팁

다음도 참조하세요.

돌아가기

쿼리 계획 캐시

다음

planCacheClearFilters