Elasticsearch核心指南全量数据类型详解与最优选型策略一、前言二、Elasticsearch 核心数据类型分类1. 字符串类型最常用2. 数值类型3. 日期类型4. 布尔类型5. 复杂类型6. 特殊类型三、ES 数据类型选型核心流程图四、核心数据类型详解使用场景1. 字符串类型text / keyword2. 数值类型6种3. 日期类型date4. 布尔类型boolean5. 对象类型object / nested6. 特殊高频类型五、数据类型最优选择规则序号化1. 字符串字段选型规则2. 数字字段选型规则3. 时间字段选型规则4. 嵌套对象选型规则5. 特殊字段选型规则六、企业级索引建模实战示例七、高频踩坑避坑指南八、总结The Begin点点关注收藏不迷路一、前言在 Elasticsearch 索引建模过程中数据类型的定义是最基础、最核心的环节直接决定了索引的存储大小、查询性能、检索精度和功能可用性。很多新手在建模时随意指定数据类型最终导致数据存储冗余、聚合排序失效、查询超时、数据丢失等严重问题。本文将系统梳理 ES 支持的所有核心数据类型结合选型流程图、实战场景、避坑指南手把手教你为业务选择最合适的数据类型。二、Elasticsearch 核心数据类型分类ES 数据类型非常丰富按照功能和用途可分为6大类覆盖所有业务场景1. 字符串类型最常用text全文本类型分词存储支持全文检索keyword关键字类型不分词支持精确匹配/聚合/排序2. 数值类型integer整型-2³¹ ~ 2³¹-1long长整型超大整数float单精度浮点型double双精度浮点型short短整型byte字节型unsigned_long无符号长整型3. 日期类型date日期类型支持字符串、毫秒值、秒值格式如2025-01-01、2025-01-01 12:00:004. 布尔类型boolean布尔值仅支持true/false5. 复杂类型object对象类型存储嵌套 JSON 对象nested嵌套类型解决对象数组关联查询问题flattened扁平化类型将整个对象作为一个字段存储6. 特殊类型ipIP 地址类型支持 CIDR 格式查询geo_point地理坐标类型存储经纬度支持地理位置检索range范围类型存储数值/日期/IP 范围binary二进制类型存储 Base64 编码数据version版本号类型支持语义化版本比较三、ES 数据类型选型核心流程图这是企业级开发通用选型流程图遇到任何字段直接按流程判断即可字符串是否数字小整数普通整数大整数小数时间真假JSON对象是否IP地址经纬度待定义字段字段类型是什么?需要全文检索?text类型keyword类型数值范围?byte/shortintegerlongfloat/doubledate类型boolean类型数组对象关联查询?nested类型object类型ip类型geo_point地理类型四、核心数据类型详解使用场景1. 字符串类型text / keyword最容易混淆必须严格区分text特性自动分词建立词条索引支持全文检索、模糊匹配不支持聚合、排序、精确匹配场景文章正文、商品描述、评论、标题全文搜索keyword特性不分词完整存储字符串支持精确查询、聚合、排序、去重场景手机号、订单号、状态码、标签、用户名、城市2. 数值类型6种遵循原则能用小类型不用大类型节省存储空间byte-128~127如状态值0/1short-32768~32767如年龄、数量integer常用默认整型如用户ID、商品库存long超大数字如订单ID、分布式IDfloat单精度小数如简单评分double双精度小数如金额、经纬度高精度3. 日期类型date特性自动解析多种日期格式内部以毫秒存储支持范围查询、按时间聚合、时区转换场景创建时间、更新时间、下单时间、日志时间示例格式2025-01-01、2025-01-01 10:00:00、17356896000004. 布尔类型boolean特性仅存 true/false存储空间极小场景是否删除、是否上架、是否VIP、开关状态优势查询速度极快过滤性能最高5. 对象类型object / nestedobject普通对象场景单层嵌套对象如用户信息{name:张三,age:20}限制对象数组会丢失内部关联关系无法精准查询nested嵌套类型场景对象数组如订单商品列表[{name:手机,price:3000},...]优势保留对象关联关系支持精准嵌套查询6. 特殊高频类型ip专门存储IPv4/IPv6支持IP段过滤场景日志IP、访问IPgeo_point存储经纬度纬度,经度场景外卖地址、地图定位、附近的人range存储范围场景价格区间、时间区间、IP区间五、数据类型最优选择规则序号化1. 字符串字段选型规则长文本 需要全文搜索 →text短文本 精确匹配/聚合/排序 →keyword既需要全文搜索又需要聚合 →text keyword 多字段2. 数字字段选型规则优先选择最小可用类型减少存储占用状态/标识 → byte年龄/库存/普通ID → integer分布式ID/超大数值 → long金额/高精度数据 → double3. 时间字段选型规则所有时间相关字段统一用 date禁止用字符串/数字存储时间无法使用时间相关函数4. 嵌套对象选型规则单个对象 → object对象数组 需要精准查询 → nested无需查询的大JSON → flattened5. 特殊字段选型规则IP地址 → 必须用 ip 类型不要用keyword经纬度 → 必须用 geo_point布尔状态 → 必须用 boolean六、企业级索引建模实战示例{mappings:{properties:{// 商品标题全文搜聚合 → 多字段title:{type:text,fields:{keyword:{type:keyword,ignore_above:256}}},// 商品描述仅全文搜 → textdesc:{type:text},// 商品分类精确匹配 → keywordcategory:{type:keyword},// 价格小数 → doubleprice:{type:double},// 库存整数 → integerstock:{type:integer},// 状态0/1 → bytestatus:{type:byte},// 创建时间 → datecreate_time:{type:date},// 是否上架 → booleanis_on_sale:{type:boolean},// 商家IP → ipmerchant_ip:{type:ip},// 店铺位置经纬度 → geo_pointlocation:{type:geo_point},// 商品列表对象数组 → nestedgoods_list:{type:nested,properties:{name:{type:text},price:{type:double}}}}}}七、高频踩坑避坑指南坑1用 text 存储手机号/订单号 → 无法精确查询✅ 解决必须用 keyword坑2用 keyword 存储长文章 → 无法全文搜索✅ 解决必须用 text坑3用字符串存储时间 → 无法按时间范围查询/聚合✅ 解决统一用 date坑4对象数组用 object 类型 → 查询结果错误✅ 解决关联查询必须用 nested坑5所有数字都用 long → 存储空间浪费、查询变慢✅ 解决按数值大小选择最小类型坑6IP 地址用 keyword → 不支持IP段检索✅ 解决用 ip 类型八、总结本文全面梳理了 Elasticsearch6大类核心数据类型提供了可视化选型流程图和企业级实战规则核心选型思想总结为3句话字符串全文搜用text精确/聚合用keyword数值能用小类型不用大类型按需选择专用场景时间用date、IP用ip、经纬度用geo_point、对象数组用nested严格按照以上规则选型能让你的 ES 索引存储更小、查询更快、功能更稳定从根源避免建模问题。The End点点关注收藏不迷路