/ /

인덱스 참조

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

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

쿼리 요구 사항에 따라 MongoDB 검색 인덱스를 정의하는 방법을 학습하려면 MongoDB 검색 인덱스 관리를 참조하세요. 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`에서 동적으로 인덱싱할 수 있는 모든 필드 유형을 자동으로 인덱싱합니다. 또한 `dynamic` 를 `false`로 설정하여 명시적으로 재정의하지 않는 한, MongoDB 검색하다는 `document` 아래에 있는 모든 중첩된 문서를 재귀적으로 인덱싱합니다. `typeSets`를 사용하여 지정된 필드 유형만 인덱스 하도록 동적 인덱싱 구성할 수도 있습니다. 동적 매핑에 활성화 할 수 있는 필드 유형에 대해 학습하려면 MongoDB 검색 필드 유형을 참조하세요. 인덱스 구성의 예시 는 예시를 참조하세요.
`mappings.` `dynamic.` `typeSet`	문자열	옵션	자동으로 재귀적으로 인덱스 할 필드 유형 목록이 포함된 `typeSets` 객체 의 이름을 참조합니다. `mappings.dynamic` 불리언 플래그와 상호 배타적입니다. 중요 구성 가능한 동적 매핑이 Preview에 있습니다. 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. 자세히 학습 미리보기 기능을 참조하세요.
`mappings.` `fields`	객체	조건부	인덱스 할 필드를 지정합니다. 동적 매핑이 `false`인 경우에만 필요합니다. 필드 이름 시작 부분에 달러(`$`) 기호가 포함된 필드는 인덱싱할 수 없습니다. 자세한 내용은 필드 매핑 정의를 참조하세요.
`searchAnalyzer`	문자열	옵션	검색하기 전에 쿼리 텍스트에 적용할 분석기를 지정합니다. 지정하지 않으면 `analyzer` 옵션에 지정한 분석기가 기본값으로 사용됩니다. `searchAnalyzer` 및 `analyzer` 옵션을 모두 지정하지 않으면 기본값은 표준 분석기로 설정됩니다.
`numPartitions`	Integer	옵션	문서 수가 20억 개를 초과하는 경우 생성할 하위 인덱스의 수를 지정합니다. 유효한 값은 다음과 같습니다: `1`, `2`, `4`. 이를 생략하는 경우 기본값은 `1`입니다. 인덱스 파티션을 사용하려면 클러스터 에 검색 노드가 배포되어 있어야 합니다.
`storedSource`	불리언 또는 저장된 소스 정의	옵션	반환된StoredSource 옵션을 사용하여 쿼리 시간 조회를 위해 저장 문서의 필드를 지정합니다. MongoDB 검색에서 모든 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 검색 쿼리 요구 사항을 충족하도록 MongoDB 검색 인덱스를 정의하는 방법을 학습하려면 MongoDB 검색 인덱스 관리를 참조하세요.

클러스터에 인덱스 추가하는 방법을 학습 보려면 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` 프로세스가 설치되지 않았거나 실행 중이지 않음