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

planCacheSetFilter

이 페이지의 내용

정의

planCacheSetFilter

컬렉션 에 인덱스 필터하다 를 설정합니다. 쿼리 형태 에 대한 인덱스 필터하다 가 이미 있는 경우 이 명령은 이전 인덱스 필터하다 를 재정의합니다.

호환성

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

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

중요

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

구문

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

db.runCommand(
   {
      planCacheSetFilter: <collection>,
      query: <query>,
      sort: <sort>,
      projection: <projection>,
      collation: { <collation> },
      indexes: [ <index1>, <index2>, ...],
      comment: <any>
   }
)

인덱스 필터의 쿼리 형태는 다음의 조합입니다.

  • query

  • sort

  • projection

  • collation

명령 필드

명령에는 다음과 같은 필드가 있습니다.

필드
유형
설명

planCacheSetFilter

문자열

인덱스 필터에 대한 collection의 이름입니다.

query

문서

인덱스 필터에 대한 쿼리 조건자입니다.

필드 이름을 포함한 조건자 구조만 인덱스 필터에 사용됩니다. 쿼리 조건자의 필드 값이 사용되지 않습니다. 따라서 인덱스 필터의 쿼리 조건자는 필드 값만 다른 유사한 쿼리에서 사용됩니다.

sort

문서

선택 사항. 인덱스 필터의 정렬입니다.

projection

문서

선택 사항. 인덱스 필터의 프로젝션입니다.

collation

문서

작업에 사용할 데이터 정렬을 지정합니다.

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우( db.createCollection() 참조), 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다.

컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.

한 연산에 대해 여러 데이터 정렬을 지정할 수 없습니다. 예를 들어 필드별로 서로 다른 데이터 정렬을 지정할 수 없으며 정렬과 함께 찾기를 수행하는 경우 찾기 와 정렬에서 각각 다른 데이터 정렬을 사용하는 것은 허용되지 않습니다.

MongoDB 6.0부터 인덱스 필터는 이전에 명령을 planCacheSetFilter 사용하여 설정한 데이터 정렬을 사용합니다.

indexes

배열

지정된 쿼리 형태에 대한 인덱스 필터의 배열입니다.

인덱스 필터를 다음 배열 중 하나로 지정합니다:

  • 인덱스 사양 문서. 예를 들어 [ { x : 1 }, ... ] 입니다.

  • 인덱스 이름. 예를 들어 [ "x_1", ... ] 입니다.

쿼리 옵티마이저 는 쿼리 계획을 위해 collection 스캔 또는 인덱스 배열을 사용합니다. 지정된 인덱스가 존재하지 않거나 숨겨진 경우 옵티마이저는 컬렉션 스캔을 사용합니다.

동일한 키 패턴을 가진 여러 인덱스의 경우 인덱스를 이름 배열로 지정해야 합니다.

comment

any

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

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

인덱스 필터는 서버 프로세스가 실행되는 동안에만 존재하며 종료 후에는 유지되지 않습니다. 인덱스 필터를 지우려면 planCacheClearFilters 명령을 사용합니다.

필요한 액세스 권한

사용자는 planCacheIndexFilter 조치를 포함하는 액세스 권한이 있어야 합니다.

예시

조건자로만 구성된 쿼리 형태에 필터 설정

다음 예에서는 orders collection에 대한 인덱스 필터를 만들어 프로젝션 및 정렬 없이 status 필드의 동등성 매치로만 구성된 쿼리의 경우 쿼리 옵티마이저는 지정된 두 인덱스만 평가하고 컬렉션 스캔은 다음에 대해 성공적인 계획:

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { status: "A" },
      indexes: [
         { cust_id: 1, status: 1 },
         { status: 1, order_date: -1 }
      ]
   }
)

쿼리 조건자에서는 필드 이름을 포함한 조건자의 구조만 중요합니다. 값은 중요하지 않습니다. 따라서 생성된 필터는 다음 작업에 적용됩니다.

db.orders.find( { status: "D" } )
db.orders.find( { status: "P" } )

MongoDB가 쿼리 형태에 인덱스 필터를 적용할지 여부를 확인하려면 indexFilterSet db.collection.explain() cursor.explain() 또는 메서드의 필드를 확인합니다.

조건자, 프로젝션 및 정렬로 구성된 쿼리 형태에 필터 설정

다음 예제에서는 orders collection에 대한 인덱스 필터를 만듭니다. 이 필터는 조건자가 item 필드의 동등성 매치인 쿼리에 적용되며, 여기서 quantity 필드만 프로젝션되고 order_date 기준 오름차순 정렬이 지정됩니다.

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { item: "ABC" },
      projection: { quantity: 1, _id: 0 },
      sort: { order_date: 1 },
      indexes: [
         { item: 1, order_date: 1 , quantity: 1 }
      ]
   }
)

쿼리 형태의 경우 쿼리 옵티마이저는 인덱스 { item: 1, order_date: 1, quantity: 1 } 를 사용하는 인덱싱된 계획만 고려합니다.

조건자 및 데이터 정렬로 구성된 쿼리 형태에 필터 설정

다음 예제에서는 orders collection에 대한 인덱스 필터를 만듭니다. 이 필터는 조건자가 item 필드 및 데이터 정렬 en_US (영어 미국)에서 동등성 매치인 쿼리에 적용됩니다.

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { item: "Movie" },
      collation: { locale: "en_US" },
      indexes: [
         { item: 1, order_date: 1 , quantity: 1 }
      ]
   }
)

쿼리 형태의 경우 쿼리 옵티마이저는 인덱스 { item: 1, order_date: 1, quantity: 1 } 를 사용하는 인덱싱된 계획만 사용합니다.

MongoDB 부터 6.0 인덱스 필터는 명령을 planCacheSetFilter 사용하여 이전에 설정한 데이터 정렬 을 사용합니다.

팁

다음도 참조하세요.

돌아가기

planCacheListFilters

다음

인증