인덱스 참조

MongoDB Search 인덱스 클러스터 의 문서를 해당 문서에서 추출된 텀에 매핑하는 데이터 구조입니다. MongoDB Search 인덱스를 사용하면 데이터베이스 의 효율적인 전체 텍스트 검색을 활성화 .

MongoDB Search 인덱스 정의할 때 정적 또는 동적 매핑을 사용하여 컬렉션 에서 인덱스 할 필드 또는 필드 유형을 지정할 수 있습니다.분석기를 사용하여 MongoDB Search가 필드 또는 쿼리 문자열에서 검색 가능한 토큰을 추출하는 방법을 정의할 수도 string 있습니다. 마지막으로, 인덱스 정의에 추가 구성 옵션을 적용 MongoDB Search 쿼리 의 성능과 정확성을 개선하거나, 인덱스 에 소스 필드를 저장 옵션을 포함하여, 동의어 매핑을 정의할 수 있습니다.

쿼리 요구 사항에 따라 MongoDB Search 인덱스 정의하는 방법을 학습 MongoDB Search 인덱스 관리를 참조하세요. MongoDB Search 인덱스 정의한 후에는 MongoDB Search 인덱스 만들기 튜토리얼을 통해 클러스터 에 인덱스 추가할 수 있습니다. MongoDB Search 인덱스 보고, 편집하거나, 업데이트, 삭제 방법을 학습 지원되는 클라이언트를 참조하세요.

이 페이지에서는 MongoDB Search 인덱스 에 대한 JSON 구문 및 정의 옵션에 대해 설명합니다.

구문

1 { 
2   "mappings": { 
3     "dynamic": <boolean> | { <field-types-definition> } , 
4     "fields": { <field-definition> } 
5   }
6 }
7

1 {
2   "analyzer": "<analyzer-for-index>", 
3   "searchAnalyzer": "<analyzer-for-query>", 
4   "mappings": { 
5     "dynamic": <boolean> | { 
6       "typeSet": "<typeSet-name>" 
7     } , 
8     "fields": { 
9       <field-definition> 
10     } 
11   },
12   "numPartitions": <integer>,
13   "analyzers": [ <custom-analyzer> ],
14   "storedSource": <boolean> | {
15     <stored-source-definition>
16   },
17   "synonyms": [
18     {
19       <synonym-mapping-definition>
20     }
21   ],
22   "typeSets": [
23     {
24       "types": [
25         {<field-types-definition>}
26       ]
27     }
28   ]
29 }

옵션

필드	유형	필요성	설명
`analyzer`	문자열	옵션	인덱싱할 때 문자열 필드에 적용할 분석기를 지정합니다. 이를 맨 위에만 설정하다 하고 인덱스 정의에서 필드에 대한 분석기 지정하지 않으면 MongoDB Search는 이 분석기 모든 필드에 적용합니다. 각 필드 에 대해 다른 분석기 사용하려면 필드 에 대해 다른 분석기 지정해야 합니다. 지정하지 않으면 기본적으로 표준 분석기가 사용됩니다.
`analyzers`	사용자 지정 분석기 배열	옵션	이 인덱스에서 사용할 사용자 지정 분석기를 지정합니다.
`mappings`	문서 필드 정의	필수 사항	이 인덱스에 대해 서로 다른 경로에서 필드를 인덱싱하는 방법을 지정합니다.
`mappings.dynamic`	부울 또는 객체	옵션	필드 유형의 동적 매핑을 활성화하거나 이 인덱스 에 대해 필드를 개별적으로 구성합니다. 값은 다음 중 하나여야 합니다. 부울 - 인덱싱 가능한 모든 필드 유형을 재귀적으로 인덱스 하려면 `true` 로 설정하다 , 인덱싱 가능한 필드 유형을 동적으로 인덱스 하지 않으려면 `false` 로 설정하다 . 객체 - 인덱싱 가능한 모든 필드 유형을 재귀적으로 인덱싱 데 사용할 `typeSet` 를 지정합니다. 자세한 학습 은 `mappings.dynamic.typeSet`를 참조하세요. 생략하면 기본값은 `false`입니다. `false`로 설정하다 경우 `mappings.fields`를 사용하여 정적으로 인덱스 할 개별 필드를 정의해야 합니다. `mappings.fields`을(를) 사용하여 기본값 설정을 재정의하도록 필드를 개별적으로 구성할 수도 있습니다. `mappings.fields` 의 필드에 대한 설정이 기본값 설정을 재정의합니다. 중요: MongoDB Search는 에서 `document` 동적으로 인덱싱할 수 있는 모든 필드 유형을 자동으로 인덱싱합니다.`document` 또한 를 `dynamic` 로 설정하여 명시적으로 재정의하지 않는 한, MongoDB Search는 아래에 있는 모든 중첩된 문서를 재귀적으로 `false` 인덱싱합니다. 를 사용하여 지정된 필드 유형만 인덱스 하도록 동적 인덱싱 구성할 수도 `typeSets` 있습니다. 동적 매핑에 활성화 할 수 있는 필드 유형에 대해 학습 MongoDB 검색 필드 유형을 참조하세요. 인덱스 구성의 예시 는 예제를 참조하세요.
`mappings.dynamic.typeset`	객체	옵션	자동으로 재귀적으로 인덱스 할 필드 유형 목록이 포함된 `typeSets` 객체 의 이름을 참조합니다. `mappings.dynamic` 부울 플래그와 상호 배타적입니다. 중요 구성 가능한 동적 매핑이 Preview에 있습니다. 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. 자세히 학습 미리보기 기능을 참조하세요.
`mappings.fields`	문서	조건부	인덱스 할 필드를 지정합니다. 동적 매핑이 `false`인 경우에만 필요합니다. 필드 이름 시작 부분에 달러(`$`) 기호가 포함된 필드는 인덱싱할 수 없습니다. 자세한 내용은 필드 매핑 정의를 참조하세요.
`searchAnalyzer`	문자열	옵션	검색하기 전에 쿼리 텍스트에 적용할 분석기를 지정합니다. 지정하지 않으면 `analyzer` 옵션에 지정한 분석기가 기본값으로 사용됩니다. `searchAnalyzer` 및 `analyzer` 옵션을 모두 지정하지 않으면 기본값은 표준 분석기로 설정됩니다.
`numPartitions`	int	옵션	문서 수가 20억 개를 초과하는 경우 생성할 하위 인덱스의 수를 지정합니다. 유효한 값은 다음과 같습니다: `1`, `2`, `4`. 이를 생략하는 경우 기본값은 `1`입니다. 인덱스 파티션을 사용하려면 클러스터 에 검색 노드가 배포되어 있어야 합니다.
`storedSource`	부울 또는 저장된 소스 정의	옵션	반환된StoredSource 옵션을 사용하여 쿼리 시간 조회를 위해 저장 문서의 필드를 지정합니다. MongoDB Search에서 모든 MongoDB 검색 필드 유형의 필드를 저장 수 있습니다. 값은 다음 중 하나일 수 있습니다. `true`, 모든 필드를 저장하려는 경우 `false`, 어떤 필드도 저장하지 않으려는 경우 스토리지에서 `include` 또는 `exclude`으로 필드를 지정하는 객체입니다. `storedSource` 다음 버전 중 하나를 실행 클러스터에서만 사용할 수 있습니다. MongoDB 7.0+ 생략하는 경우 기본값은 `false`입니다. 자세한 학습 은 MongoDB 검색 인덱스에 저장된 소스 필드 정의를 참조하세요.
`synonyms`	동의어 매핑 정의의 배열	옵션	인덱스 에 사용할 동의어 매핑을 지정합니다. 인덱스 정의에는 동의어 매핑이 하나만 있을 수 있습니다. 자세한 학습은 MongoDB 검색 인덱스에서 동의어 매핑 정의를 참조하세요.
`typeSets`	객체 배열	옵션	동적 매핑을 위해 이 인덱스 에서 사용할 typeSets를 지정합니다.
`typeSets.[n].name`	문자열	필수 사항	`typeSet` 구성의 이름을 지정합니다.
`typeSets.[n].types`	객체 배열	필수 사항	동적 매핑을 사용하여 자동으로 인덱스 할 필드 유형을 객체 당 하나씩 지정합니다.
`typeSets.[n].types.[n].type`	문자열	필수 사항	자동으로 인덱스 할 필드 유형을 지정합니다. 동적 매핑을 위해 구성할 수 있는 필드 유형에 대해 자세히 학습 구성을 참조하세요.`typeSet`

인덱스 문제 해결

`mongot` 프로세스가 설치되지 않았거나 실행 중이지 않음

MongoDB Search mongot 프로세스 설치되어 있지 않거나 실행 아닌 상태에서 $search 쿼리를 실행 다음 오류가 반환됩니다.

MongoError: Remote error from mongot :: caused by :: Error connecting to localhost:28000.

mongot 프로세스 첫 번째 MongoDB Search 인덱스 정의된 경우에만 설치됩니다. 클러스터 에 MongoDB Search 인덱스 없는 경우, 이 오류를 해결하려면 MongoDB Search 인덱스 하나 이상 생성하세요.

자세히 알아보기

MongoDB Search 쿼리 요구 사항을 충족하도록 MongoDB Search 인덱스 정의하는 방법을 학습 MongoDB Search 인덱스 관리를 참조하세요.

클러스터 에 인덱스 추가하는 방법을 학습 MongoDB 검색 인덱스 만들기를 참조하세요.

사용 가능한 인덱스 구성 옵션에 대해 자세히 알아보려면 다음 참조 페이지를 확인하세요.

돌아가기

색인 관리

분석기

1	{
2	"mappings": {
3	"dynamic": <boolean> \| { <field-types-definition> } ,
4	"fields": { <field-definition> }
5	}
6	}
7

1	{
2	"analyzer": "<analyzer-for-index>",
3	"searchAnalyzer": "<analyzer-for-query>",
4	"mappings": {
5	"dynamic": <boolean> \| {
6	"typeSet": "<typeSet-name>"
7	} ,
8	"fields": {
9	<field-definition>
10	}
11	},
12	"numPartitions": <integer>,
13	"analyzers": [ <custom-analyzer> ],
14	"storedSource": <boolean> \| {
15	<stored-source-definition>
16	},
17	"synonyms": [
18	{
19	<synonym-mapping-definition>
20	}
21	],
22	"typeSets": [
23	{
24	"types": [
25	{<field-types-definition>}
26	]
27	}
28	]
29	}

구문

옵션

중요

인덱스 문제 해결

mongot 프로세스가 설치되지 않았거나 실행 중이지 않음

자세히 알아보기

`mongot` 프로세스가 설치되지 않았거나 실행 중이지 않음