NoSQL 与搜索 / 系统课时
term 精确查询
term 精确查询
本课使用一组商品文档演示 term、terms 与 exists 查询,重点解决状态、编号、标签和字段存在性筛选,并说明为什么精确查询通常应面向 keyword、数值或布尔字段。
学习目标
- 能使用
term查询单个精确值 - 能使用
terms查询多个候选值 - 能使用
exists判断字段是否具有可检索值
准备示例数据
下面的映射将 orderNo、status 和 tags 定义为 keyword,避免分词器改变原始值;amount 使用数值类型,remark 保持可选。
PUT lesson-term-demo
{
"mappings": {
"properties": {
"orderNo": { "type": "keyword" },
"status": { "type": "keyword" },
"tags": { "type": "keyword" },
"amount": { "type": "double" },
"remark": { "type": "keyword" }
}
}
}
POST lesson-term-demo/_bulk?refresh=true
{"index":{"_id":"1"}}
{"orderNo":"ORD-1001","status":"PAID","tags":["vip","mobile"],"amount":99.9,"remark":"first-order"}
{"index":{"_id":"2"}}
{"orderNo":"ORD-1002","status":"PENDING","tags":["web"],"amount":35.0}
{"index":{"_id":"3"}}
{"orderNo":"ORD-1003","status":"CLOSED","tags":["vip","web"],"amount":120.0,"remark":""}预期结果(保留关键字段)
{
"errors": false
}返回结果还会包含每条写入操作的状态信息,具体字段和耗时可能不同;关键是 errors 为 false。
使用 term 查询单个值
term 不会分析查询值,而是直接匹配倒排索引中的完整词项。查询已支付订单时,查询值的大小写和字符必须与索引中的词项一致。
GET lesson-term-demo/_search
{
"query": {
"term": {
"status": "PAID"
}
}
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 1,
"relation": "eq"
},
"hits": [
{
"_id": "1",
"_source": {
"orderNo": "ORD-1001",
"status": "PAID"
}
}
]
}
}实际响应还会包含 _index、_score、took 等字段。精确筛选通常放在 bool.filter 中,因为过滤条件不需要相关性评分,并且更容易被缓存。
使用 terms 查询多个值
terms 接收一个值数组,只要字段命中其中任意一个值,文档就会被选中。它适合状态集合、编号集合或标签集合等“多选一”条件。
GET lesson-term-demo/_search
{
"_source": ["orderNo", "status"],
"query": {
"terms": {
"status": ["PAID", "PENDING"]
}
},
"sort": [
{ "orderNo": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
},
"hits": [
{
"_source": {
"orderNo": "ORD-1001",
"status": "PAID"
}
},
{
"_source": {
"orderNo": "ORD-1002",
"status": "PENDING"
}
}
]
}
}terms 是“字段值属于给定集合”,不是要求数组字段同时包含所有候选值。若查询 tags: ["vip", "mobile"],文档只要包含其中任意标签即可命中。
使用 exists 判断字段存在性
exists 判断字段是否具有已建立索引的值,而不是简单检查 JSON 中是否出现字段名。示例中只有文档 1 和文档 3 包含 remark 字段。
GET lesson-term-demo/_search
{
"_source": ["orderNo", "remark"],
"query": {
"exists": {
"field": "remark"
}
},
"sort": [
{ "orderNo": "asc" }
]
}预期结果(保留关键字段)
{
"hits": {
"total": {
"value": 2,
"relation": "eq"
}
}
}空字符串 "" 仍然是一个可索引值,因此文档 3 会命中;null、缺失字段以及被映射规则忽略的值通常不会命中。查询“字段不存在”时,可把 exists 放入 bool.must_not。
关键边界与常见错误
不要直接对普通 text 字段使用 term 查询用户输入,因为文本在写入时通常会被分词。例如名称字段若同时提供 name 和 name.keyword,全文检索使用 match 查询 name,精确筛选使用 term 查询 name.keyword。
term 与 terms 都区分实际索引词项。状态码、订单号和标签最好在写入前统一大小写、空格和格式,避免同一业务值以多种形式进入索引。
本课总结
term精确匹配一个词项,适合keyword、数值和布尔字段terms匹配候选集合中的任意值,不表示“全部同时满足”exists判断字段是否有可检索值,空字符串与null的行为不同
下一课预告
下一课将使用 range、prefix 和 wildcard 查询处理数值区间、时间范围以及字符串模式匹配。