Fields 参数（Multi-fields） #

fields 参数允许你对同一个字段以多种方式进行索引。这是 Easysearch 中最常用的映射技巧之一，典型场景是：一个字段同时需要全文搜索（text）和精确匹配/排序/聚合（keyword）。

基本语法 #

PUT my-index
{
  "mappings": {
    "properties": {
      "title": {
        "type": "text",
        "fields": {
          "raw": {
            "type": "keyword"
          }
        }
      }
    }
  }
}

上面的映射中，title 字段被索引为 text（用于全文搜索），同时通过 fields.raw 创建了一个 keyword 子字段（用于精确匹配、排序和聚合）。

查询时使用方式：

全文搜索："match": { "title": "搜索引擎" }
精确匹配："term": { "title.raw": "Easysearch 分布式搜索引擎" }
排序："sort": [{ "title.raw": "asc" }]
聚合："aggs": { "titles": { "terms": { "field": "title.raw" } } }

常见用法 #

1. text + keyword（最典型） #

"name": {
  "type": "text",
  "analyzer": "ik_max_word",
  "fields": {
    "keyword": {
      "type": "keyword",
      "ignore_above": 256
    }
  }
}

提示：Easysearch 的动态映射默认就为字符串字段创建这种 text + keyword 的多字段结构。

2. 同一字段使用不同分析器 #

"content": {
  "type": "text",
  "analyzer": "ik_max_word",
  "fields": {
    "standard": {
      "type": "text",
      "analyzer": "standard"
    },
    "pinyin": {
      "type": "text",
      "analyzer": "pinyin"
    }
  }
}

这样可以在搜索时选择最合适的分析器：

content：中文分词搜索
content.standard：英文/通用搜索
content.pinyin：拼音搜索

3. keyword + 不同 normalizer #

"status": {
  "type": "keyword",
  "fields": {
    "lower": {
      "type": "keyword",
      "normalizer": "lowercase"
    }
  }
}

注意事项 #

要点	说明
子字段继承	子字段不会继承父字段的参数，必须独立配置
存储开销	每个子字段都会独立存储索引数据，增加磁盘空间
动态映射	默认动态映射会为字符串自动创建 `text` + `keyword` 子字段
更新限制	已有索引的 `fields` 可以追加新子字段，但不能修改已有子字段
查询方式	使用 `字段名.子字段名` 的点号语法访问子字段

与 copy_to 的对比 #

特性	fields（多字段）	copy_to
作用	同一字段多种索引方式	将值复制到另一个独立字段
访问方式	`field.subfield`	直接使用目标字段名
_source	不出现在 `_source` 中	不出现在 `_source` 中
典型场景	text + keyword	多个字段合并到一个搜索字段