可观测性与稳定性 / 系统课时

term 查询适合什么字段

term 查询适合什么字段

term 查询用于匹配索引中的精确值,最适合日志等级、服务名、环境名和状态码等不需要全文分词的字段。关键不是字段看起来像字符串还是数字,而是它如何被映射和索引:精确字段保留明确值,全文文本则通常交给 match 查询。

学习目标

  • 判断哪些日志字段适合使用 term 查询。
  • 区分 keyword、数值字段与 text 字段在精确查询中的差异。
  • 能创建最小字段映射并验证一次 term 查询结果。

term 匹配精确索引值

term 属于 term-level 查询。它不会像 match 那样先对查询文本执行全文分析,而是直接查找字段中的精确索引值。因此,枚举、标识符和精确数值通常很适合它。

字段示例 推荐映射 适合 term 的原因
level keyword ERROR、WARN 等值应整体匹配
service keyword 服务名通常是稳定标识
status integer 状态码需要按精确数值过滤
environment keyword prod、staging 等是枚举值

如果字段是 text,写入内容通常会经过分析器处理,例如分词或转小写。原始字符串未必以完整形式存在于倒排索引中,因此不应把 term 当作普通全文搜索工具。

用显式映射验证查询

下面创建独立索引,把 service 和 level 定义为 keyword,把 status 定义为 integer,再精确查询服务名 checkout-api。请把 <PASSWORD> 替换为实际密码。

bash
curl -s -k -u elastic:<PASSWORD> -X DELETE 'https://localhost:9200/logs-term-demo' >/dev/null
curl -s -k -u elastic:<PASSWORD> -H 'Content-Type: application/json' -X PUT 'https://localhost:9200/logs-term-demo' -d '{"mappings":{"properties":{"service":{"type":"keyword"},"level":{"type":"keyword"},"status":{"type":"integer"},"message":{"type":"text"}}}}' >/dev/null
curl -s -k -u elastic:<PASSWORD> -H 'Content-Type: application/x-ndjson' -X POST 'https://localhost:9200/logs-term-demo/_bulk?refresh=true' --data-binary $'{"index":{"_id":"1"}}\n{"service":"checkout-api","level":"ERROR","status":503,"message":"Payment gateway timeout"}\n{"index":{"_id":"2"}}\n{"service":"catalog-api","level":"INFO","status":200,"message":"Cache warmed"}\n' >/dev/null
curl -s -k -u elastic:<PASSWORD> -H 'Content-Type: application/json' -X POST 'https://localhost:9200/logs-term-demo/_search?filter_path=hits.total,hits.hits._source' -d '{"query":{"term":{"service":"checkout-api"}}}'

预期输出

json
{
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "hits": [
      {
        "_source": {
          "service": "checkout-api",
          "level": "ERROR",
          "status": 503,
          "message": "Payment gateway timeout"
        }
      }
    ]
  }
}

字段显示顺序可能不同,但应只返回 checkout-api 日志。把查询字段改成 status、查询值改成数值 503,也会命中同一条记录,因为 status 是精确数值字段。

为什么不直接查 text 字段

假设 message 是 text,写入 Payment gateway timeout 后,默认分析过程通常会产生 payment、gateway、timeout 等词项。此时用 term 查询完整句子,并不等价于“查找包含这句话的日志”。

如果业务既要全文搜索,又要按原始字符串精确筛选,可以使用多字段映射:主字段使用 text,同时提供一个 keyword 子字段。全文检索走 match,精确筛选走 term,两者职责分开。

大小写和映射是常见边界

keyword 字段默认保留写入后的精确值,因此 ERROR 与 error 通常不是同一个值。如果日志来源大小写不统一,应在采集阶段统一格式,或为 keyword 字段配置合适的 normalizer,而不是期望 term 自动完成全文分析。

选择 term 前先检查字段映射:枚举、标识符、状态码和其他精确字段优先考虑 term;需要按自然语言内容搜索的 text 字段通常使用 match。 根据映射判断,比只看字段表面上是不是字符串更可靠。

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

目录与阅读设置

阅读设置

17

记录一个想法

term 查询适合什么字段

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

登录哪都通