定义字段映射

动态映射

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

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

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

要了解哪些数据类型支持动态索引，请参阅下方的数据类型部分。

静态映射

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

当您对包含多态数据的字段进行静态索引， MongoDB Search 仅对与该字段的索引定义中指定的映射相对应的文档进行索引。MongoDB 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。如果您希望查询词的解析术语与其在MongoDB搜索索引中的存储方式不同，则可以更改搜索分析器。

• 索引指定静态字段映射 (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分析器进行查询。对于索引数组， MongoDB 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。如果您希望查询词的解析术语与其在MongoDB搜索索引中的存储方式不同，则可以更改搜索分析器。

• 索引指定静态字段映射 (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
      }
    }
  }
}