NoSQL 与搜索 / 系统课时
范围与前缀查询
范围与前缀查询
本课通过日志文档演示 range、prefix 和 wildcard 查询,完成金额区间、时间窗口、编号前缀与通配模式筛选,并说明这些查询对字段类型和性能的要求。
学习目标
- 能使用
range表达数值与日期边界 - 能使用
prefix匹配固定开头的字符串 - 能判断何时应谨慎使用
wildcard
准备示例数据
示例将时间字段映射为 date,金额映射为 double,日志编号和路径映射为 keyword,以保证范围比较和字符串模式查询按预期工作。
PUT lesson-range-demo
{
"mappings": {
"properties": {
"logId": { "type": "keyword" },
"createdAt": { "type": "date" },
"amount": { "type": "double" },
"path": { "type": "keyword" }
}
}
}
POST lesson-range-demo/_bulk?refresh=true
{"index":{"_id":"1"}}
{"logId":"PAY-20260801-001","createdAt":"2026-08-01T09:15:00+08:00","amount":80.0,"path":"/api/pay/create"}
{"index":{"_id":"2"}}
{"logId":"PAY-20260801-002","createdAt":"2026-08-01T18:30:00+08:00","amount":260.0,"path":"/api/pay/query"}
{"index":{"_id":"3"}}
{"logId":"REFUND-20260802-001","createdAt":"2026-08-02T10:00:00+08:00","amount":120.0,"path":"/api/refund/create"}预期结果(保留关键字段)
{
"errors": false
}响应中的耗时和逐条写入信息可能不同;只要 errors 为 false,即可继续执行查询。
使用 range 查询数值区间
range 通过 gt、gte、lt、lte 表达开区间和闭区间。下面查询金额大于等于 100 且小于 300 的文档。
GET lesson-range-demo/_search
{
"_source": ["logId", "amount"],
"query": {
"range": {
"amount": {
"gte": 100,
"lt": 300
}
}
},
"sort": [
{ "amount": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
},
"hits": [
{
"_source": {
"logId": "REFUND-20260802-001",
"amount": 120.0
}
},
{
"_source": {
"logId": "PAY-20260801-002",
"amount": 260.0
}
}
]
}
}边界是否包含必须由业务规则决定。价格下限常用 gte,上限若用于分桶,常用 lt 避免相邻区间重复包含同一个值。
使用 range 查询时间范围
日期字段同样使用 range。下面按马来西亚时区查询 2026 年 8 月 1 日整天的数据,并使用“左闭右开”区间避免毫秒精度和日末边界问题。
GET lesson-range-demo/_search
{
"_source": ["logId", "createdAt"],
"query": {
"range": {
"createdAt": {
"gte": "2026-08-01T00:00:00",
"lt": "2026-08-02T00:00:00",
"time_zone": "+08:00"
}
}
},
"sort": [
{ "createdAt": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
},
"hits": [
{
"_source": {
"logId": "PAY-20260801-001"
}
},
{
"_source": {
"logId": "PAY-20260801-002"
}
}
]
}
}time_zone 用于解释查询中的日期边界,不会修改索引中保存的时间。生产代码应明确约定写入时区和查询时区,避免把本地日期直接当作 UTC。
使用 prefix 匹配固定前缀
prefix 查询匹配以指定字符开头的词项,适合结构稳定的订单号、日志号或分类编码。下面筛选所有支付日志。
GET lesson-range-demo/_search
{
"_source": ["logId"],
"query": {
"prefix": {
"logId": {
"value": "PAY-"
}
}
},
"sort": [
{ "logId": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
},
"hits": [
{
"_source": {
"logId": "PAY-20260801-001"
}
},
{
"_source": {
"logId": "PAY-20260801-002"
}
}
]
}
}prefix 更适合 keyword 字段。若编号前缀承担高频筛选职责,可额外拆出 type、date 等独立字段,用 term 和 range 组合查询,通常比长期依赖字符串前缀更清晰。
使用 wildcard 处理通配模式
wildcard 支持 * 匹配任意长度字符,? 匹配单个字符。下面查找路径中包含 pay 的接口。
GET lesson-range-demo/_search
{
"_source": ["logId", "path"],
"query": {
"wildcard": {
"path": {
"value": "*pay*"
}
}
},
"sort": [
{ "logId": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
}
}
}前导通配符会扩大需要检查的词项范围,数据量大时可能明显增加开销。可预知的业务条件应优先建模为独立字段;只有无法提前拆分且数据规模可控时,再使用复杂 wildcard 模式。
组合查询与选择原则
范围、前缀和通配查询通常属于筛选条件,可放入 bool.filter。数值或日期区间优先使用 range,固定开头优先使用 prefix,任意位置模式匹配才考虑 wildcard。
不要在 text 字段上假设原始字符串仍完整存在。需要模式匹配时,应查询对应的 keyword 子字段,或为专门的搜索需求设计合适的映射。
本课总结
range用四种边界运算符表达数值和日期区间prefix适合固定开头的keyword词项wildcard灵活但可能昂贵,前导*尤其需要谨慎
下一课预告
下一课将把多个查询条件组合进 bool 查询,学习 must、filter、should 和 must_not 的协作方式。