首页/数据/NoSQL 速查/常用 mapping 参数
本包目录(322 条)
MongoDB99 条
Elasticsearch89 条
ClickHouse56 条时序与列式28 条选型与架构50 条

常用 mapping 参数

除类型外,字段级参数能控制索引与存储行为:index 关闭检索、doc_values 关闭列存、ignore_above 截断、null_value 提供默认值、format 约定日期格式。

NoSQL 速查数据更新于 2026-10-12
indexfalse 时不建索引,不可检索,但仍在 _source
doc_valuesfalse 时不能排序聚合,可省磁盘
ignore_above超过长度的字符串不建索引
null_value把 JSON null 替换为一个可索引的默认值
format日期解析格式,如 epoch_millis||strict_date_optional_time

示例

示例
PUT /metrics-000001/_mapping
{
  "properties": {
    "debug_payload": { "type": "keyword", "index": false },
    "sample_raw": { "type": "double", "doc_values": false },
    "trace_id": { "type": "keyword", "ignore_above": 128 }
  }
}
index:false 常用于只回显、不搜索的大字段;这类字段也不能用于排序聚合。

易错点

  • 对 index:false 字段发起查询不会报错但永远无命中,排查时容易被忽略
  • null_value 只影响索引值,_source 里仍保留原始 null

数据来源与参考

  • Elasticsearch Guide: Mapping parameters
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌