定义字段映射

动态映射

使用动态映射自动索引集合中受支持类型的所有字段。仅当您的模式定期更改或未知，或者您正在试验Atlas Search，我们才建议使用动态映射。动态映射索引比静态映射索引占用更多磁盘空间，并且性能可能较低。

当您对包含多态数据的字段进行动态索引， Atlas Search会自动将该字段索引为与该数据对应的所有可动态索引的字段类型。如果该字段包含Atlas Search不会自动索引的数据类型，Atlas Search不会对该数据索引。

Atlas Search使用检测到的数据类型的默认设置动态索引文档中的所有字段。 Atlas Search还会动态索引该文档下的所有嵌套文档，除非您通过将 dynamic 设置为 false 来明确覆盖。

要学习；了解哪些数据类型支持动态索引，请参阅下面的“数据类型”部分。

静态映射

使用静态映射为您不希望动态编制索引选项，或者独立于索引中的其他字段配置单个字段。当您使用静态映射时， Atlas Search仅对您在 mappings.fields 中指定的字段建立索引。

当您对包含多态数据的字段进行静态索引， Atlas Search仅索引与该字段的索引定义中指定的映射相对应的文档。 Atlas Search不会索引与该字段的索引定义中指定的数据类型不匹配的文档。

要定义嵌套字段的索引，必须为该嵌套字段的每个父字段定义映射。不能使用点表示法对嵌套字段进行静态索引。有关示例，请参阅下面的示例或组合映射示例。

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

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

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 分析器进行查询。

  • 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 分析器进行查询。

  • 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
      }
    }
  }
}