第二阶段 12 · range 范围查询

阶段第二阶段 / 查询能力ES 查询range| PostgreSQL 对照BETWEEN//1. 概念range用于数值、日期、字符串的范围过滤。参数参数含义SQL 对应gt大于gte大于等于lt小于lte小于等于range通常放在filter上下文里不需要相关性打分。2. PostgreSQL 对照-- 数值范围SELECT*FROMsalesdataWHEREnet_amountBETWEEN1000AND5000;-- 日期范围SELECT*FROMsalesdataWHEREinvoice_dt2026-01-01ANDinvoice_dt2026-07-01;3. ES DSL数值范围GET salesdata_idx/_search { query: { range: { net_amount: { gte: 1000, lte: 5000 } } } }日期范围支持日期数学表达式GET salesdata_idx/_search { query: { range: { invoice_dt: { gte: 2026-01-01, lt: 2026-07-01 } } } }日期数学示例gte: now-7d/d表示「最近 7 天」/d表示按天取整。放进 filter推荐{ query: { bool: { filter: [ { range: { net_amount: { gte: 1000 } } } ] } } }4. Spring Boot 实现ComponentpublicclassDoc12RangeQuery{AutowiredprivateElasticsearchClientelasticsearchClient;/** net_amount BETWEEN min AND max */publicListMapString,ObjectbyAmountRange(StringindexName,doublemin,doublemax)throwsIOException{SearchResponseMaprespelasticsearchClient.search(s-s.index(indexName).query(q-q.range(r-r.field(net_amount).gte(JsonData.of(min)).lte(JsonData.of(max)))),Map.class);returntoSourceList(resp);}/** invoice_dt from AND invoice_dt to */publicListMapString,ObjectbyDateRange(StringindexName,Stringfrom,Stringto)throwsIOException{SearchResponseMaprespelasticsearchClient.search(s-s.index(indexName).query(q-q.range(r-r.field(invoice_dt).gte(JsonData.of(from)).lt(JsonData.of(to)))),Map.class);returntoSourceList(resp);}privateListMapString,ObjecttoSourceList(SearchResponseMapresp){returnresp.hits().hits().stream().map(Hit::source).filter(Objects::nonNull).collect(Collectors.toList());}}注意 importco.elastic.clients.json.JsonData。range的边界值在 8.x 客户端用JsonData.of(...)包装可传数值、字符串日期等。5. 坑与最佳实践gte/lte别混用成BETWEEN语义错误BETWEEN是闭区间[a,b]对应gte lte。日期字段要有正确 mappingtype: date且format匹配写入格式否则范围失效。半开区间更安全按天/月过滤时用gte 起 lt 下一个起点避免边界重复。放 filter范围过滤几乎都不需要打分放filter更快、可缓存。字符串 range 慎用keyword也能范围比较但一般只对数值/日期有意义。下一篇13-bool-组合查询.md最重要的一篇AND/OR/NOT 全靠它。