NoSQL 与搜索 / 系统课时

范围与前缀查询

范围与前缀查询

本课通过日志文档演示 range、prefix 和 wildcard 查询,完成金额区间、时间窗口、编号前缀与通配模式筛选,并说明这些查询对字段类型和性能的要求。

学习目标

  • 能使用 range 表达数值与日期边界
  • 能使用 prefix 匹配固定开头的字符串
  • 能判断何时应谨慎使用 wildcard

准备示例数据

示例将时间字段映射为 date,金额映射为 double,日志编号和路径映射为 keyword,以保证范围比较和字符串模式查询按预期工作。

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

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

json
{
  "errors": false
}

响应中的耗时和逐条写入信息可能不同;只要 errors 为 false,即可继续执行查询。

使用 range 查询数值区间

range 通过 gt、gte、lt、lte 表达开区间和闭区间。下面查询金额大于等于 100 且小于 300 的文档。

json
GET lesson-range-demo/_search
{
  "_source": ["logId", "amount"],
  "query": {
    "range": {
      "amount": {
        "gte": 100,
        "lt": 300
      }
    }
  },
  "sort": [
    { "amount": "asc" }
  ]
}

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

json
{
  "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 日整天的数据,并使用“左闭右开”区间避免毫秒精度和日末边界问题。

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

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

json
{
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    },
    "hits": [
      {
        "_source": {
          "logId": "PAY-20260801-001"
        }
      },
      {
        "_source": {
          "logId": "PAY-20260801-002"
        }
      }
    ]
  }
}

time_zone 用于解释查询中的日期边界,不会修改索引中保存的时间。生产代码应明确约定写入时区和查询时区,避免把本地日期直接当作 UTC。

使用 prefix 匹配固定前缀

prefix 查询匹配以指定字符开头的词项,适合结构稳定的订单号、日志号或分类编码。下面筛选所有支付日志。

json
GET lesson-range-demo/_search
{
  "_source": ["logId"],
  "query": {
    "prefix": {
      "logId": {
        "value": "PAY-"
      }
    }
  },
  "sort": [
    { "logId": "asc" }
  ]
}

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

json
{
  "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 的接口。

json
GET lesson-range-demo/_search
{
  "_source": ["logId", "path"],
  "query": {
    "wildcard": {
      "path": {
        "value": "*pay*"
      }
    }
  },
  "sort": [
    { "logId": "asc" }
  ]
}

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

json
{
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    }
  }
}

前导通配符会扩大需要检查的词项范围,数据量大时可能明显增加开销。可预知的业务条件应优先建模为独立字段;只有无法提前拆分且数据规模可控时,再使用复杂 wildcard 模式。

组合查询与选择原则

范围、前缀和通配查询通常属于筛选条件,可放入 bool.filter。数值或日期区间优先使用 range,固定开头优先使用 prefix,任意位置模式匹配才考虑 wildcard。

不要在 text 字段上假设原始字符串仍完整存在。需要模式匹配时,应查询对应的 keyword 子字段,或为专门的搜索需求设计合适的映射。

本课总结

  • range 用四种边界运算符表达数值和日期区间
  • prefix 适合固定开头的 keyword 词项
  • wildcard 灵活但可能昂贵,前导 * 尤其需要谨慎

下一课预告

下一课将把多个查询条件组合进 bool 查询,学习 must、filter、should 和 must_not 的协作方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

范围与前缀查询

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

登录哪都通