Atlas Search 인덱스에 저장된 소스 필드 정의
Atlas Search 인덱스 정의 의 storedSource
옵션은 Atlas Search가 저장해야 하는 소스 문서의 필드를 지정합니다. storedSource
를 구성하여 백엔드 데이터베이스에서 암시적 쿼리 시간 조회의 필요성을 줄여 특정 사용 사례 에서 쿼리 성능을 향상시킬 수 있습니다. Atlas Search에는 모든 데이터 유형 의 필드를 저장할 수 있습니다.
Atlas Search는 저장된 필드를 인덱싱하지 않습니다. 따라서 필드에서 쿼리를 실행하려면 필드를 별도로 인덱싱해야 합니다. 쿼리 시 returnStoredSource 옵션을 사용해 저장된 필드를 조회할 수도 있습니다.
참고
storedSource
은 다음 버전 중 하나를 실행하는 Atlas 클러스터에서만 사용할 수 있습니다.
MongoDB 5.0.6+
MongoDB 6.0+
MongoDB 7.0+
저장된 필드를 조회하는 방법에 대해 자세히 알아보려면 저장된 소스 필드 반환을 참조하세요.
구문
인덱스 정의에서 storedSource
옵션의 구문은 다음과 같습니다.
{ ..., "storedSource": true | false | { "include" | "exclude": [ "<field-name>", ... ] } }
옵션
storedSource
옵션은 부울 값 또는 인덱스 정의 의 객체를 사용합니다.
부울 값
값 | 설명 |
---|---|
true | Atlas Search가 문서의 모든 필드를 저장하도록 지정합니다. 전체 문서를 저장하면 인덱싱 및 쿼리 중 성능에 큰 영향을 미칠 수 있습니다. 자세한 내용은 소스 필드 저장을 참조하세요. |
false | Atlas Search가 원본 소스 문서를 저장하지 않도록 지정합니다. 이는 storedSource 옵션의 기본값입니다. |
개체
storedSource
옵션 객체는 다음 필드 중 하나를 허용합니다.
참고
객체에는 include
또는 exclude
가 포함되어야 합니다.
필드 | 유형 | 설명 |
---|---|---|
include | 문자열 배열 | 저장할 필드 이름 또는 점으로 구분된 필드 경로가 포함된 목록입니다. Atlas Search는 지정된 필드 외에도 기본적으로 _id 도 저장합니다. |
exclude | 문자열 배열 | 저장에서 제외할 필드 이름 또는 점으로 구분된 필드의 경로가 포함된 목록입니다. 지정된 경우, Atlas Search는 여기에 나열된 필드를 제외한 원본 문서를 저장합니다. |
예제
다음 인덱스 예제에서는 collection의 필드를 사용하여 sample_mflix.movies
Atlas Search 옵션을 사용하여 Atlas Search에 저장할 필드를 구성하는 storedSource
방법을 보여 줍니다. Atlas UI의 비주얼 편집기 또는 JSON 편집기를 사용하여 인덱스를 구성할 수 있습니다.