NoSQL 与搜索 / 系统课时

term 精确查询

term 精确查询

本课使用一组商品文档演示 term、terms 与 exists 查询,重点解决状态、编号、标签和字段存在性筛选,并说明为什么精确查询通常应面向 keyword、数值或布尔字段。

学习目标

  • 能使用 term 查询单个精确值
  • 能使用 terms 查询多个候选值
  • 能使用 exists 判断字段是否具有可检索值

准备示例数据

下面的映射将 orderNo、status 和 tags 定义为 keyword,避免分词器改变原始值;amount 使用数值类型,remark 保持可选。

json
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":""}

预期结果(保留关键字段)

json
{
  "errors": false
}

返回结果还会包含每条写入操作的状态信息,具体字段和耗时可能不同;关键是 errors 为 false。

使用 term 查询单个值

term 不会分析查询值,而是直接匹配倒排索引中的完整词项。查询已支付订单时,查询值的大小写和字符必须与索引中的词项一致。

json
GET lesson-term-demo/_search
{
  "query": {
    "term": {
      "status": "PAID"
    }
  }
}

预期结果(保留关键字段)

json
{
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "hits": [
      {
        "_id": "1",
        "_source": {
          "orderNo": "ORD-1001",
          "status": "PAID"
        }
      }
    ]
  }
}

实际响应还会包含 _index、_score、took 等字段。精确筛选通常放在 bool.filter 中,因为过滤条件不需要相关性评分,并且更容易被缓存。

使用 terms 查询多个值

terms 接收一个值数组,只要字段命中其中任意一个值,文档就会被选中。它适合状态集合、编号集合或标签集合等“多选一”条件。

json
GET lesson-term-demo/_search
{
  "_source": ["orderNo", "status"],
  "query": {
    "terms": {
      "status": ["PAID", "PENDING"]
    }
  },
  "sort": [
    { "orderNo": "asc" }
  ]
}

预期结果(保留关键字段)

json
{
  "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 字段。

json
GET lesson-term-demo/_search
{
  "_source": ["orderNo", "remark"],
  "query": {
    "exists": {
      "field": "remark"
    }
  },
  "sort": [
    { "orderNo": "asc" }
  ]
}

预期结果(保留关键字段)

json
{
  "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 查询处理数值区间、时间范围以及字符串模式匹配。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

term 精确查询

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通