字段类型 #

Easysearch 提供丰富的字段类型，用于存储和索引不同类型的数据。选择正确的字段类型对查询性能和存储效率至关重要。

概念指南 → 了解如何设计映射，请阅读：

• 映射基础
• 映射模式与常见坑

字段类型速查 #

文本与关键字 #

选型建议：

• 需要全文搜索 → text
• 需要精确匹配/聚合/排序 → keyword
• 两者都需要 → 使用 fields 多字段映射

数值类型 #

选型建议：选择能容纳数据范围的最小类型，节省存储和内存。

日期与时间 #

布尔与二进制 #

对象与嵌套 #

选型建议：

• 简单对象 → object
• 对象数组且需要精确匹配单个元素 → nested
• 键名动态变化 → flattened

地理位置 #

范围类型 #

搜索增强 #

向量类型 #

特殊类型 #

插件提供的字段类型 #

场景选型指南 #

数组 #

Easysearch 没有专门的数组类型。任何字段都可以包含零个或多个值，但数组中所有值必须是相同类型。

PUT testindex/_doc/1
{
  "tags": ["elastic", "search", "engine"]
}

多字段（Multi-fields） #

使用 fields 参数为同一字段创建多种索引方式：

PUT products
{
  "mappings": {
    "properties": {
      "title": {
        "type": "text",
        "analyzer": "ik_max_word",
        "fields": {
          "keyword": {
            "type": "keyword"
          },
          "pinyin": {
            "type": "text",
            "analyzer": "pinyin"
          }
        }
      }
    }
  }
}

• title → 全文搜索（中文分词）
• title.keyword → 精确匹配、聚合
• title.pinyin → 拼音搜索

空值处理（null_value） #

默认情况下，null 值无法被搜索。使用 null_value 参数指定替代值：

PUT users
{
  "mappings": {
    "properties": {
      "phone": {
        "type": "keyword",
        "null_value": "N/A"
      }
    }
  }
}

索引文档时，null 会被替换为 "N/A"，从而可以通过 term 查询搜索到。

动态映射 #

Easysearch 默认开启动态映射，自动为新字段推断类型：

建议：生产环境使用显式映射，避免动态推断导致类型不一致。