Docs Menu
Docs Home
/
MongoDB Atlas
/ / / /

패싯 검색을 위해 숫자 값을 인덱싱하는 방법

이 페이지의 내용

  • numberFacet 제한 사항 검토
  • 0} 유형에 대한 인덱스 정의 numberFacet
  • 0}numberFacet 필드 속성 구성
  • 0} 유형에 대한 예제를 사용해 보세요.numberFacet

Atlas Search numberFacet 유형을 사용하면 지정된 패싯 representation 을(를) 사용하여 숫자 값을 인덱싱할 수 있습니다. BSON types int32, int64double 의 번호를 인덱싱할 수 있습니다.

Atlas Search는 numberFacet 유형으로 인덱싱된 필드에 대한 패싯 쿼리만 지원합니다. 동일한 필드에 대해서도 일반 검색을 수행하려면 필드를 number 유형으로 인덱싱해야 합니다.

내장된 문서의 문자열 필드를 패싯하려면 상위 필드를 문서 유형으로 인덱싱해야 합니다. 내장된 문서 내부의 문자열 필드를 패싯하는 경우 Atlas Search는 일치하는 상위 문서 수에 대해서만 패싯 수를 반환합니다.

Atlas Search는 패싯에 대해 number 값을 동적으로 인덱싱하지 않습니다. 정적 매핑 을 사용하여 패싯의 number 값을 인덱싱해야 합니다. Atlas UI의 비주얼 편집기 또는 JSON 편집기 를 사용하여 number 필드를 numberFacet 유형으로 인덱싱할 수 있습니다.

다음과 같은 제한 사항이 적용됩니다:

  • 패싯에 대해 decimal128 을(를) 인덱싱할 수 없습니다.

  • 배열이나 배열에 포함된 문서의 숫자 값을 패싯으로 인덱스할 수 없습니다.

  • embeddedDocuments 필드의 일부로 인덱싱된 숫자 필드는 패싯할 수 없습니다.

numberFacet 유형에 대한 인덱스를 정의하려면 Atlas UI에서 원하는 구성 방법을 선택한 다음 데이터베이스와 컬렉션을 선택하세요.

  1. 인덱스를 구성하려면 Refine Your Index 을 클릭합니다.

  2. Field Mappings 섹션에서 Add Field Mapping 을 클릭하여 Add Field Mapping창을 엽니다.

  3. Customized Configuration를 클릭합니다.

  4. Field Name 드롭다운에서 인덱스할 필드를 선택합니다.

    참고

    필드 이름 시작 부분에 달러($) 기호가 포함된 필드는 인덱싱할 수 없습니다.

  5. Data Type 드롭다운을 클릭하여 NumberFacet를 선택합니다.

  6. numberFacet 유형에 대한 필드 속성을 구성합니다. 자세히 알아보려면 필드 속성 을 참조하세요.

  7. Add를 클릭합니다.

다음은 numberFacet 유형에 대한 JSON 구문입니다. 기본 인덱스 정의를 다음으로 바꿉니다. 필드에 대해 자세히 알아보려면 필드 속성을 참조하세요.

{
"mappings": {
"dynamic": true|false,
"fields": {
"<field-name>": {
"type": "numberFacet",
"representation": "int64|double",
"indexIntegers": true|false,
"indexDoubles": true|false
}
}
}
}

Atlas Search numberFacet 유형은 다음 매개 변수를 사용합니다.

옵션
유형
필요성
설명
기본값
type
문자열
필수 사항
필드의 유형입니다. 값은 numberFacet 이어야 합니다.
representation
문자열
옵션

인덱싱할 필드의 데이터 유형입니다. 값은 다음 BSON types 중 하나일 수 있습니다.

  • int64 - 정밀도 손실 없이 큰 정수를 인덱싱하고 double 값을 정수로 반올림하는 데 사용됩니다. 이 유형은 큰 double 값을 인덱싱하는 데 사용할 수 없습니다.

  • double - 큰 double 값을 반올림하지 않고 인덱싱하는 데 사용됩니다.

자세한 내용은 아래 예시를 참조하세요.

double
indexIntegers
부울
옵션
int32int64 유형 값을 인덱싱할지 또는 인덱싱을 생략할지를 나타냅니다. 값은 true 또는 false 일 수 있습니다. 이 값 또는 indexDoublestrue 여야 합니다.
true
indexDoubles
부울
옵션
double 유형 값을 인덱싱할지 또는 인덱싱을 생략할지를 나타냅니다. 값은 true 또는 false 일 수 있습니다. 이 값 또는 indexIntegerstrue 여야 합니다.
true

다음 인덱스 정의 예시에서는 sample_mflix.movies 컬렉션을 사용합니다. cluster에 이미 샘플 데이터가 로드되어 있는 경우, Atlas UI의 Visual Editor 또는 JSON Editor를 사용하여 인덱스를 구성할 수 있습니다. 원하는 구성 방법을 선택한 후 데이터베이스와 컬렉션을 선택하고 인덱스를 구체화하여 필드 매핑을 추가합니다.

다음 인덱스 정의 예시는 year 필드를 Atlas Search numberFacet 유형으로 인덱싱하여 Atlas Search 패싯을 사용하여 해당 필드에 대한 쿼리를 지원합니다.

  1. Add Field Mapping 창의 Field Name 드롭다운에서 year 을 선택합니다.

  2. Data Type 드롭다운을 클릭하여 NumberFacet를 선택합니다.

  3. NumberFacet Properties 의 기본값을 그대로 사용합니다.

  4. Add를 클릭합니다.

기본 인덱스 정의를 다음 인덱스 정의로 바꾸세요.

{
"mappings": {
"dynamic": false,
"fields": {
"year": {
"type": "numberFacet"
}
}
}
}

다음 예제 인덱스 정의는 year 필드를 numberFacetnumber 유형으로 인덱싱하여 쿼리에 대해 다음 유형의 결과를 반환합니다.

  1. Add Field Mapping 창의 Field Name 드롭다운에서 year 을 선택합니다.

  2. Data Type 드롭다운을 클릭하여 NumberFacet를 선택합니다.

  3. NumberFacet Properties 의 기본값을 그대로 사용합니다.

  4. Add를 클릭합니다.

  5. 1 단계를 반복하여 Data Type 드롭다운에서 Number 을(를) 선택합니다.

  6. Number Properties 의 기본값을 그대로 사용합니다.

  7. Add를 클릭합니다.

기본 인덱스 정의를 다음 인덱스 정의로 바꾸세요.

{
"mappings": {
"dynamic": false,
"fields": {
"year": [
{
"type": "numberFacet"
},
{
"type": "number"
}
]
}
}
}

추가 인덱스 정의에 대한 예시도 참조하세요.

추가 인덱스 정의 예시는 다음 페이지를 참조하세요.

돌아가기

숫자