查看 Atlas Search 搜索索引语法

在此页面上

语法

选项

Atlas Search 可以通过不同的方式对数据进行索引。定义 Atlas Search 索引时，您可以指定一个特定分析器或多个分析器来索引某些字段。要了解详情，请参阅使用分析器处理数据。您还可以对某些字段进行索引并省略其他字段，或者可以动态对集合中的所有字段进行索引。要了解更多信息，请参阅定义字段映射。您可以通过Atlas 用户界面、 Atlas Search API 、 Atlas CLI 、 mongosh或驱动程序定义 Atlas Search 索引。

本页介绍了 Atlas Search 索引的 JSON 语法和字段。

重要

如果您使用 $out 聚合阶段修改具有 Atlas Search 索引的集合，则必须删除并重新创建搜索索引。如果可能，请考虑使用 $merge 而不是 $out。

语法

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

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

选项

字段	类型	必要性	说明
`analyzer`	字符串	Optional	指定在建立索引时应用于字符串字段的分析器。如果您仅在顶部设置此项，并且没有为索引定义中的字段指定分析器，则 Atlas Search 会将此分析器应用于所有字段。若要为每个字段使用不同的分析器，必须为该字段指定不同的分析器。如果省略，则默认为标准分析器。
`analyzers`	自定义分析器数组	Optional	指定在该索引中使用的自定义分析器。
`mappings`	文档字段定义	必需	指定如何在该索引的不同路径中对字段进行索引。
`mappings.dynamic`	布尔	Optional	为该索引的字段启用或禁用动态映射。如果设置为 `true`，Atlas Search 将递归索引所有动态可索引字段。如果设置为 `false`，您必须使用 `mappings.fields` 指定要进行索引的各个字段。如果省略，则默认值为 `false`。重要 Atlas Search 使用检测到的数据类型的默认设置动态对 `document` 中的所有字段进行索引。Atlas Search 还会动态对 `document` 中嵌套的所有文档进行索引，除非您将 `dynamic` 设置为 `false`以明确覆盖该行为。要了解更多信息，请参阅索引配置示例。
`mappings.fields`	文档	可选的	仅在禁用了动态映射时才是必需的。指定要编制索引的字段。要了解更多信息，请参阅定义字段映射。注意您无法对字段名称开头包含美元 (`$`) 符号的字段创建索引。
`searchAnalyzer`	字符串	Optional	指定在使用查询文本进行搜索之前为其应用的分析器。如果省略，则默认为您为 `analyzer` 选项指定的分析器。如果同时省略 `searchAnalyzer` 和 `analyzer` 选项，则默认为标准分析器。
`storedSource`	布尔值或存储的源定义	Optional	使用 returnedStoredSource 选项指定要存储的文档字段，以便在查询时查找。您可以在 Atlas Search 上存储所有数据类型的字段。值可以是以下值之一： `true`— 存储所有字段 `false`— 不存储任何字段指定在存储中包括 (`include`) 或排除 (`exclude`) 的字段的对象如果省略，则默认值为 `false`。要了解有关语法和字段的更多信息，请参阅在 Atlas Search 索引中定义存储源字段。注意 `storedSource` 仅适用于运行以下版本之一的 Atlas 集群： MongoDB 5 。 0 。 6 + MongoDB 6.0+ MongoDB 7.0+
`synonyms`	同义词映射定义数组	Optional	要在索引中使用的同义词映射。要了解更多信息，请参阅在 Atlas Search 索引中定义同义词映射。注意一个索引定义只能具有一个同义词映射。

后退

4：配置同义词映射

来年

恢复或删除草稿

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

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

重要

语法

选项

重要

注意

注意

注意