쿼리 형태

쿼리 형태 일치

다음 예시 쿼리 형태 는 기본값 test 데이터베이스 의 pizzaOrders 컬렉션 에 대한 find 명령의 사양을 보여줍니다.

find: "pizzaOrders",
filter: {
   orderDate: { $gt: ISODate( "2023-01-20T00:00:00Z" ) }
},
sort: {
   totalNumber: 1
},
$db: "test"

예시 필터하다 는 주문 날짜가 지정된 날짜보다 큰 문서로 문서를 제한합니다. 이 예시 에서는 주문한 총 피자 수를 오름차순으로 정렬합니다.

MongoDB 8.0 queryShapeHash 및 planCacheShapeHash 16진수 문자열을 보려면 explain 명령을 사용할 수 있습니다.

다음 explain 예제에는 동일한 쿼리 형태 를 가진 쿼리가 포함되어 있습니다.

db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2024-05-10T05:15:35Z" ) } } ).
   sort( { totalNumber: 1 }
)
db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2024-02-05T07:07:16Z" ) } } ).
   sort( { totalNumber: 1 }
)
db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2023-03-08T08:12:25Z" ) } } ).
   sort( { totalNumber: 1 }
)

쿼리 형태가 동일하기 때문에 explain 출력은 각 예제에 대해 동일한 queryShapeHash 와 각 예제에 대해 동일한 planCacheShapeHash 를 갖습니다. 예를 예시 다음과 같습니다.

queryShapeHash: 'AB8ECADEE8F0EB0F447A30744EB4813AE7E0BFEF523B0870CA10FCBC87F5D8F1'
planCacheShapeHash: '48E51110'

다양한 쿼리 형태

쿼리 의 사양이 다른 경우 쿼리 의 형태도 달라집니다. 예를 예시 쿼리 에 다른 필터하다, 정렬, 프로젝션, 네임스페이스 또는 집계 파이프라인 단계 가 있는 경우입니다.

이전 섹션의 예시 에서는 totalNumber 필드 예시 기준으로 정렬합니다. 쿼리 정렬을 totalNumber 에서 다른 필드 로 변경하면 쿼리의 쿼리 쿼리 형태 가 달라집니다.

예를 예시 피자 price 를 기준으로 정렬하면 쿼리 형태 가 변경됩니다.

db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2023-01-20T00:00:00Z" ) } } ).
   sort( { price: 1 }
)

쿼리 형태 가 이전 섹션의 형태와 다르기 때문에 explain 출력은 이전 예시 와 다른 queryShapeHash 및 다른 planCacheShapeHash 을 갖습니다. 예를 예시 다음과 같습니다.

queryShapeHash: 'AC1ECADBE8F1EB0F417A30741AB4813BE7E0BFEF523B0870CA11FCBC87F1A8B2'
planCacheShapeHash: '31A52130'

쿼리 형태 해시 안정성

MongoDB derives the queryShapeHash from the query shape itself, not from the deployment that runs the query. In current supported versions, the same query shape is expected to produce the same queryShapeHash:

• 배포서버 의 모든 노드 에서 .

• 복제본 세트 및 샤딩된 클러스터

클러스터, MongoDB 버전 전체 또는 마이그레이션 후에도 해시를 재사용하기 전에 해시가 여전히 일치하는지 확인하세요.

배포서버 의 모든 노드 에 있는 쿼리 형태 에 동일한 쿼리 설정을 적용 할 수 있습니다. 복제본 세트 에서 샤딩된 클러스터 로 또는 다른 클러스터 로 마이그레이션 후 쿼리 형태 해시로 지정한 쿼리 설정을 사용하기 전에 해시가 대상 배포서버 에서 여전히 일치하는지 확인합니다.