NoSQL 与搜索 / 系统课时
映射的作用
映射的作用
Mapping 决定 Elasticsearch 如何理解字段、如何建立索引,以及查询时采用什么规则。本课通过一个显式映射示例,说明字段类型从写入到检索的完整影响,并解释为什么生产索引不应完全依赖自动推断。
学习目标
- 说明 Mapping 对字段解析、索引和查询行为的影响
- 创建并查看一个显式映射
- 识别动态映射和字段类型变更的主要风险
Mapping 控制字段的完整生命周期
文档写入索引时,Elasticsearch 先根据 Mapping 解析字段值,再按字段类型建立倒排索引、数值索引或日期索引。查询阶段,查询语句也会读取同一份 Mapping,决定是否分词、能否执行范围查询,以及是否支持排序和聚合。

同一个原始值,因为 Mapping 不同,后续能力也会不同。例如字符串映射为 text 时会被分析器拆分,映射为 keyword 时则作为整体保存;价格映射为 double 后可以进行范围过滤,而错误映射为字符串会使数值比较失去正确语义。
创建显式映射
下面的命令假设本机 Elasticsearch 通过 http://localhost:9200 访问且未启用认证。示例关闭未知字段的自动创建,并明确声明四个业务字段。
# 创建索引并固定字段类型
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预期输出:
{"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 的索引方式,并使用多字段设计同时支持全文检索、排序和聚合。