定义字段映射

静态映射

使用静态映射为不希望动态添加索引的字段配置索引选项，或不依赖索引中其他字段而配置单个字段。

对于静态映射，将 mappings.dynamic 设置为 false，并使用 mappings.fields 指定要添加索引的字段。Atlas Search 仅使用特定选项为指定字段建立索引。如果索引的字段包含多态数据，则 Atlas Search 仅索引与该字段的索引定义指定的映射相对应的文档，而忽略包含如下值的文档：这些值不属于该字段的索引定义指定的数据类型。

不能使用点表示法对嵌套字段进行静态索引。为嵌套字段定义索引时，必须为该嵌套字段的每个父字段定义映射。本页的示例部分展示了嵌套在 address 字段内的 city 字段的索引语法。

动态映射

如果您的模式定期更改或未知，或者当试验 Atlas Search 时，请使用动态映射。您可以将整个索引配置为使用动态映射，或指定要动态映射的各个字段，例如document类型的字段。使用动态映射之前，请参阅数据类型表。

对于动态映射，请将 mappings.dynamic 设置为 true。Atlas Search 会自动为每个文档中支持类型 的字段建立索引。对于字符串 类型的字段，Atlas Search 会将字段存储在 mongot 上。

限制

Atlas Search停止在副本集或单个分片上复制大于 2、100、000、000索引对象的索引分片，其中每个已建立已建立索引的文档或嵌套 embeddedDocument 都算作单个对象。这意味着您的索引是可查询的，但可能会得到过时的结果。

如果计划对可能超过此限制的字段进行索引，则必须对分片进行分集群。示例，如果您使用 embeddedDocuments字段类型， Atlas Search索引的对象可能会超过此限制。这会导致索引转换为 STALE 状态，并可能导致查询结果过时。

您无法对字段名称开头包含美元 ($) 符号的字段创建索引。

将字段索引为多个数据类型

若要将字段索引为多个类型，请在字段定义数组中定义该字段的类型。

1
{
2
  ...
3
  "mappings": {
4
    "dynamic": <boolean>,
5
    "fields": {
6
      "<field-name>": [
7
        {
8
          "type": "<field-type>",
9
          ...
10
        },
11
        {
12
          "type": "<field-type>",
13
          ...
14
        },
15
        ...
16
      ],
17
      ...
18
    },
19
    ...
20
  }
21
}

静态映射示例

以下索引定义示例使用静态映射。

• 默认索引分析器是 lucene.standard

• 默认搜索分析器是 lucene.standard。如果希望查询词的解析方式与其在 Atlas Search 索引中的存储方式不同，可以更改搜索分析器。

• 索引指定静态字段映射 (dynamic: false)，这意味着未明确提及的字段不会添加索引。因此，索引定义包括：

  • address 字段，其类型为 document。它有两个嵌入式子字段，即 city 和 state。

    city 子字段默认使用 lucene.simple 分析器进行查询。它使用 ignoreAbove 选项忽略任何长度超过 255 字节的字符串。

    state 子字段默认使用 lucene.english 分析器进行查询。

  • company 字段，其类型为 string。它默认使用 lucene.whitespace 分析器进行查询。它有一个名为 mySecondaryAnalyzer 的 multi 分析器，它默认使用 lucene.french 分析器进行查询。

    要了解有关 multi 分析器的更多信息，请参阅路径构造。

  • employees 字段，它是一组字符串。默认使用 lucene.standard 分析器进行查询。 对于数组索引，Atlas Search 仅需要数组元素的数据类型。您不必在索引定义中指定该数据包含在数组中。

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "address": {
        "type": "document",
        "fields": {
          "city": {
            "type": "string",
            "analyzer": "lucene.simple",
            "ignoreAbove": 255
          },
          "state": {
            "type": "string",
            "analyzer": "lucene.english"
          }
        }
      },
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      }
    }
  }
}

组合映射示例

以下索引定义示例同时使用静态和动态映射。

• 默认索引分析器是 lucene.standard

• 默认搜索分析器是 lucene.standard。如果希望查询词的解析方式与其在 Atlas Search 索引中的存储方式不同，可以更改搜索分析器。

• 索引指定静态字段映射 (dynamic: false)，这意味着未显式提及的字段不被编入索引。因此，索引定义包括：

  • company 字段，其类型为 string。它默认使用 lucene.whitespace 分析器进行查询。它有一个名为 mySecondaryAnalyzer 的 multi 分析器，默认情况下，它使用 lucene.french 分析器进行查询。要了解有关 multi 分析器的更多信息，请参阅路径构建。

  • employees 字段，它是一组字符串。默认情况下，它使用 lucene.standard 分析器进行查询。

  • address字段，其为 document 类型。它有两个嵌入式子字段：city 和 state。索引定义不显式提及文档中的每个嵌套字段，而支持对文档中所有子字段的动态映射。默认使用 lucene.standard 分析器进行查询。

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      },
      "address": {
        "type": "document",
        "dynamic": true
      }
    }
  }
}