필드 매핑 정의

정적 매핑

정적 매핑을 사용하여 동적으로 인덱싱하지 않을 필드의 인덱스 옵션을 설정하거나, 인덱스 내의 다른 필드와 독립적으로 단일 필드를 구성하고 싶을 때 활용할 수 있습니다.

정적 매핑을 위해서는 mappings.dynamic 을 false 로 설정하고 mappings.fields를 사용하여 인덱싱할 필드를 지정합니다. Atlas Search는 특정 옵션이 있는 지정된 필드만 인덱스합니다. 인덱싱된 필드에 다형성 데이터가 포함되어 있을 경우, Atlas Search는 해당 필드의 인덱스 정의에 명시된 매핑에 해당하는 문서들만을 인덱싱하고, 해당 필드의 인덱스 정의에 지정된 데이터 유형이 아닌 값들을 포함하는 문서들은 무시합니다.

점 표기법을 사용하여 중첩된 필드를 정적으로 인덱스할 수 없습니다. 중첩된 필드의 인덱스를 정의할 때는 해당 중첩 필드의 각 상위 필드에 대한 매핑을 정의해야 합니다. 예시를 보려면 address라는 필드 안에 중첩된 city 라는 필드에 대한 인덱스 구문을 보여 주는 이 페이지의 예시를 참조하세요.

동적 매핑

스키마가 정기적으로 변경되거나 알 수 없는 경우 또는 Atlas Search를 실험할 때 동적 매핑을 사용합니다. 동적 매핑을 사용하도록 전체 인덱스를 구성하거나, document 유형의 필드와 같은 개별 필드를 동적으로 매핑하도록 지정할 수 있습니다. 동적 매핑을 사용하기 전에 데이터 유형표를 참조하세요.

동적 매핑의 경우 mappings.dynamic을 true로 설정합니다. Atlas Search는 각 문서에서 지원되는 유형 의 필드를 자동으로 인덱싱합니다. 문자열 유형의 필드의 경우 Atlas Search는 mongot에 필드를 저장합니다.

제한 사항

Atlas Search 는 복제본 세트 또는 단일 샤드 에서 2,100,000,000 인덱스 객체보다 큰 인덱스에 대한 변경 사항 복제를 중지하며, 여기서 각 인덱스된 문서 또는 중첩된 embeddedDocument 는 단일 객체 로 계산됩니다. 즉, 인덱스 를 쿼리할 수 있지만 오래된 결과가 나타날 수 있습니다.

이 제한을 초과할 수 있는 필드를 인덱스 하려는 경우 클러스터 를 샤드 해야 합니다. 예를 예시 embeddedDocuments 필드 유형을 사용하는 경우 Atlas Search 는 이 제한을 초과하여 객체를 인덱스 할 수 있습니다. 이로 인해 인덱스 가 STALE 상태로 전환되어 쿼리 결과가 오래될 수 있습니다.

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

여러 데이터 유형을 가진 인덱스 필드 설정하기

필드를 여러 유형으로 인덱싱하려면, 필드 정의 배열에서 해당 필드의 유형들을 정의하세요.

1
{
2
  ...
3
  "mappings": {
4
    "dynamic": <boolean>,
5
    "fields": {
6
      "<field-name>": [
7
        {
8
          "type": "<field-type>",
9
          ...
10
        },
11
        {
12
          "type": "<field-type>",
13
          ...
14
        },
15
        ...
16
      ],
17
      ...
18
    },
19
    ...
20
  }
21
}

동적 매핑 예시

다음 인덱스 정의 예시에서는 정적 매핑을 사용합니다.

• 기본 인덱스 분석기는 lucene.standard입니다.

• 기본 검색 분석기는 lucene.standard입니다. 검색어가 Atlas Search 인덱스에 저장되는 방식과 다르게 구문 분석되도록 하려면 검색 분석기를 변경할 수 있습니다.

• 인덱스는 정적 필드 매핑(dynamic: false)을 지정합니다. 즉, 명시적으로 언급되지 않은 필드는 인덱싱되지 않습니다. 따라서 인덱스 정의에는 다음이 포함됩니다:

  • address 필드는 document 유형입니다. 여기에는 두 개의 하위 필드 city 및 state 가 포함되어 있습니다.

    city 하위 필드는 쿼리에 기본적으로 lucene.simple 분석기를 사용합니다. ignoreAbove 옵션을 사용하여 길이가 255바이트를 초과하는 문자열을 무시합니다.

    state 하위 필드는 쿼리에 기본적으로 lucene.english 분석기를 사용합니다.

  • company 필드는 string 유형입니다. 쿼리에 기본적으로 lucene.whitespace 분석기를 사용합니다. 여기에는 mySecondaryAnalyzer 라는 이름의 multi 분석기가 있으며, 쿼리에 대해 기본적으로 lucene.french 분석기를 사용합니다.

    multi 분석기에 대해 자세히 알아보려면 경로 구성을 참조하십시오.

  • 문자열 배열인 employees 필드입니다. 쿼리에 기본적으로 lucene.standard 분석기를 사용합니다. 인덱싱 배열의 경우, Atlas Search에는 배열 요소의 데이터 유형만 필요합니다. 인덱스 정의에서 데이터가 배열에 포함되도록 지정할 필요는 없습니다.

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "address": {
        "type": "document",
        "fields": {
          "city": {
            "type": "string",
            "analyzer": "lucene.simple",
            "ignoreAbove": 255
          },
          "state": {
            "type": "string",
            "analyzer": "lucene.english"
          }
        }
      },
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      }
    }
  }
}

결합된 매핑 예시

다음 인덱스 정의 예시에서는 정적 매핑과 동적 매핑을 모두 사용합니다.

• 기본 인덱스 분석기는 lucene.standard입니다.

• 기본 검색 분석기는 lucene.standard입니다. 검색어가 Atlas Search 인덱스에 저장되는 방식과 다르게 구문 분석되도록 하려면 검색 분석기를 변경할 수 있습니다.

• 인덱스는 정적 필드 매핑(dynamic: false)을 지정합니다. 즉, 명시적으로 언급되지 않은 필드는 인덱싱되지 않습니다. 따라서 인덱스 정의에는 다음이 포함됩니다.

  • company 필드는 string 유형입니다. 쿼리에 기본적으로 lucene.whitespace 분석기를 사용합니다. 여기에는 mySecondaryAnalyzer 라는 이름의 multi 분석기가 있으며, 쿼리에 대해 기본적으로 lucene.french 분석기를 사용합니다. multi 분석기에 대해 자세히 알아보려면 경로 구성을 참조하십시오.

  • employees 필드는 문자열 배열로 이루어집니다. 쿼리에 기본적으로 lucene.standard 분석기를 사용합니다.

  • address 필드는 document 유형입니다. 여기에는 두 개의 하위 필드 city 및 state 가 포함되어 있습니다. 문서에 중첩된 각 필드를 명시적으로 언급하는 대신 인덱스 정의를 통해 문서의 모든 하위 필드에 대한 동적 매핑을 사용할 수 있습니다. 쿼리에는 기본적으로 lucene.standard 분석기를 사용합니다.

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      },
      "address": {
        "type": "document",
        "dynamic": true
      }
    }
  }
}