NoSQL 与搜索 / 系统课时

映射的作用

映射的作用

Mapping 决定 Elasticsearch 如何理解字段、如何建立索引,以及查询时采用什么规则。本课通过一个显式映射示例,说明字段类型从写入到检索的完整影响,并解释为什么生产索引不应完全依赖自动推断。

学习目标

  • 说明 Mapping 对字段解析、索引和查询行为的影响
  • 创建并查看一个显式映射
  • 识别动态映射和字段类型变更的主要风险

Mapping 控制字段的完整生命周期

文档写入索引时,Elasticsearch 先根据 Mapping 解析字段值,再按字段类型建立倒排索引、数值索引或日期索引。查询阶段,查询语句也会读取同一份 Mapping,决定是否分词、能否执行范围查询,以及是否支持排序和聚合。

Mapping 影响写入与查询的流程

同一个原始值,因为 Mapping 不同,后续能力也会不同。例如字符串映射为 text 时会被分析器拆分,映射为 keyword 时则作为整体保存;价格映射为 double 后可以进行范围过滤,而错误映射为字符串会使数值比较失去正确语义。

创建显式映射

下面的命令假设本机 Elasticsearch 通过 http://localhost:9200 访问且未启用认证。示例关闭未知字段的自动创建,并明确声明四个业务字段。

bash
# 创建索引并固定字段类型
curl -s -X PUT "http://localhost:9200/products" \
  -H "Content-Type: application/json" \
  -d '{
    "mappings": {
      "dynamic": "strict",
      "properties": {
        "name": { "type": "text" },
        "sku": { "type": "keyword" },
        "price": { "type": "double" },
        "publishedAt": {
          "type": "date",
          "format": "strict_date_optional_time||epoch_millis"
        }
      }
    }
  }'
echo

# 查看完整字段定义,便于核对结果
curl -s "http://localhost:9200/products/_mapping?filter_path=products.mappings.properties"
echo

预期输出:

text
{"acknowledged":true,"shards_acknowledged":true,"index":"products"}
{"products":{"mappings":{"properties":{"name":{"type":"text"},"price":{"type":"double"},"publishedAt":{"type":"date","format":"strict_date_optional_time||epoch_millis"},"sku":{"type":"keyword"}}}}}

字段显示顺序可能不同,但类型和日期格式应与声明一致。若环境启用了安全认证,需要把地址改为实际 HTTPS 地址,并在命令中补充证书和凭据参数。

生产环境的两个边界

动态映射适合快速试验,但它依据首次出现的值推断字段。样本不完整、日期格式不统一或数字被字符串包裹时,自动结果可能偏离业务含义。生产环境通常应显式声明核心字段,并通过动态模板约束可扩展字段;对完全固定的数据结构,可以使用 dynamic: strict,让未知字段立即报错。

字段类型一旦参与索引,通常不能在原索引中从 text 直接改为 keyword,也不能把字符串原地改成数值。正确做法是创建新索引、写入新 Mapping、执行重建索引,再通过别名切换读写目标。

提示: Mapping 变更应视为数据迁移,而不是普通配置刷新。上线前要同时验证写入兼容性、查询结果和别名切换过程。

本课总结

  • Mapping 同时约束字段解析、索引结构和查询能力
  • 核心业务字段应优先使用显式映射,避免首次样本决定长期结构
  • 不兼容的字段类型变更需要新建索引并迁移数据

下一课预告

下一课将比较 text 与 keyword 的索引方式,并使用多字段设计同时支持全文检索、排序和聚合。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

映射的作用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通