문서 메뉴

문서 홈MongoDB 실행 및 관리MongoDB Atlas

Atlas Search 인덱스 구문 검토

이 페이지의 내용

  • 구문
  • 옵션

Atlas Search는 다양한 방식으로 데이터를 인덱싱할 수 있습니다. Atlas Search 인덱스를 정의할 때 특정 분석기를 한 개 또는 여러 개 지정하여 특정 필드를 인덱싱할 수 있습니다. 자세한 내용 은 분석기를 사용하여 데이터 처리 를 참조하세요. 특정 필드를 인덱싱하고 다른 필드는 생략하거나 컬렉션의 모든 필드를 동적으로 인덱싱할 수도 있습니다. 자세한 내용은 필드 매핑 정의 를 참조하세요. Atlas UI, Atlas Search API, Atlas CLI, mongosh 또는 드라이버를 통해 Atlas Search 인덱스를 정의할 수 있습니다.

이 페이지에서는 Atlas Search 인덱스의 JSON 구문 및 필드에 대해 설명합니다.

중요

$out 애그리게이션 단계를 사용하여 Atlas Search 인덱스가 있는 컬렉션을 수정하는 경우 검색 인덱스를 삭제하고 다시 만들어야 합니다. 가능하면 $out 대신 $merge 를 사용하는 것이 좋습니다.

필드
유형
필요성
설명
analyzer
문자열
옵션
인덱싱할 때 문자열 필드에 적용할 분석기를 지정합니다. 이 옵션을 맨 위에만 설정하고 인덱스 정의에서 필드에 대한 분석기를 지정하지 않으면 Atlas Search에서 이 분석기를 모든 필드에 적용합니다. 각 필드에 대해 다른 분석기를 사용하려면 해당 필드에 다른 분석기를 지정해야 합니다. 지정하지 않으면 기본적으로 표준 분석기가 사용됩니다.
analyzers
옵션
이 인덱스에서 사용할 사용자 지정 분석기를 지정합니다.
mappings
필수 사항
이 인덱스에 대해 서로 다른 경로에서 필드를 인덱싱하는 방법을 지정합니다.
mappings.dynamic
부울
옵션

이 인덱스에 대한 필드의 동적 매핑을 사용하거나 사용하지 않도록 설정합니다.

true로 설정하면 Atlas Search는 동적으로 인덱싱할 수 있는 모든 필드를 재귀적으로 인덱싱합니다.

false로 설정하면 mappings.fields를 사용하여 인덱싱할 개별 필드를 지정해야 합니다.

생략하는 경우 기본값은 false입니다.

중요

Atlas Search는 감지된 데이터 유형에 대한 기본 설정을 사용하여 document 의 모든 필드를 동적으로 인덱싱합니다. dynamicfalse으로 설정하여 명시적으로 재정의하지 않는 한, Atlas Search는 document 아래에 있는 모든 중첩된 문서도 동적으로 색인합니다.

자세한 내용은 인덱스 구성 예제를 참조하세요.

mappings.fields
문서
조건부

동적 매핑이 비활성화된 경우에만 필요합니다.

인덱싱할 필드를 지정합니다. 자세한 내용은 필드 매핑 정의를 참조하세요.

참고

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

searchAnalyzer
문자열
옵션
검색하기 전에 쿼리 텍스트에 적용할 분석기를 지정합니다. 지정하지 않으면 analyzer 옵션에 지정한 분석기가 기본값으로 사용됩니다. searchAnalyzeranalyzer 옵션을 모두 지정하지 않으면 기본값은 표준 분석기로 설정됩니다.
storedSource
옵션

returnedStoredSource 옵션을 사용하여 쿼리 시간 조회를 위해 저장할 문서 내 필드를 지정합니다. Atlas Search에서 모든 데이터 유형의 필드를 저장할 수 있습니다. 값은 다음 중 하나일 수 있습니다.

  • true, 모든 필드를 저장하려는 경우

  • false, 어떤 필드도 저장하지 않으려는 경우

  • 스토리지에서 include 또는 exclude으로 필드를 지정하는 객체입니다.

생략하면 기본값은 false입니다. 구문 및 필드에 관한 자세한 내용은 Atlas 검색 인덱스에서 저장된 소스 필드 정의를 참조하세요.

참고

storedSource 은 다음 버전 중 하나를 실행하는 Atlas 클러스터에서만 사용할 수 있습니다.

  • MongoDB 5.0.6+

  • MongoDB 6.0+

  • MongoDB 7.0+

synonyms
옵션

인덱스에 사용할 동의어 매핑입니다. 자세한 내용은 Atlas Search 인덱스에서 동의어 매핑 정의를 참조하세요.

참고

인덱스 정의에는 동의어 매핑이 하나만 있을 수 있습니다.

← Atlas Search 인덱스에서 동의어 매핑을 정의하세요

이 페이지의 내용