3.8 Elasticsearch-搜索模板 & Mustache 动态渲染

原创于 2025-12-17 19:40:00 发布 · 356 阅读

4 ·

CC 4.0 BY-SA版权

CC BY-NC-SA 3.0

文章标签：

#elasticsearch #jenkins #大数据

elasticsearch 专栏收录该内容

35 篇文章

订阅专栏

在这里插入图片描述

3.8 Elasticsearch-搜索模板 & Mustache 动态渲染

3.8.1 为什么需要搜索模板

在实际业务里，同一条 DSL 往往要在多个场景复用：

Web、App、小程序三端检索同一批商品，只是排序字段不同；
BI 报表每天凌晨跑批，查询条件里的时间窗口由调度系统动态传入；
对外开放 API，不允许调用方拼接 DSL，防止字段名或 range 条件被恶意篡改。

搜索模板（Search Template）把“查询骨架”和“业务参数”彻底解耦：骨架存到集群里，调用方只传参数，既减少网络传输，也做到“一次编写，多处复用”。

3.8.2 模板引擎 Mustache 简介

Elasticsearch 内置的是 Mustache——Logic-less 模板语言，语法只有 3 个核心符号：

{{var}} 占位符，直接替换；
{{#section}} … {{/section}} 布尔/列表区块，真或循环才展开；
{{^inverted}} … {{/inverted}} 反向区块，假才展开。

Mustache 没有 if、else、>、< 等运算符，所有逻辑由调用方提前算好，再塞进 params，从根本上杜绝“脚本注入”风险。

3.8.3 模板的 CURD

新建/覆盖

POST _scripts/sku_search
{
  "script": {
    "lang": "mustache",
    "source": {
      "query": {
        "bool": {
          "filter": [
            { "term":  { "category": "{{cat}}" }},
            { "range": { "price": { "gte": "{{min}}", "lte": "{{max}}" }}}
          ],
          "must": [
            { "match": { "title": { "query": "{{kw}}", "boost": 2 }}}
          ]
        }
      },
      "sort": [
        { "{{sort_field}}": { "order": "{{sort_order}}" }}
      ],
      "from": "{{from}}",
      "size": "{{size}}"
    }
  }
}

查看

GET _scripts/sku_search

删除

DELETE _scripts/sku_search

3.8.4 带参调用与渲染预览

正式搜索：

GET shop/_search/template
{
  "id": "sku_search",
  "params": {
    "cat": "手机",
    "min": 0,
    "max": 5000,
    "kw": "5G 全网通",
    "sort_field": "sold",
    "sort_order": "desc",
    "from": 0,
    "size": 20
  }
}

调试阶段想看 DSL 长什么样，用 _render/template 即可：

POST _render/template/sku_search
{
  "params": { "cat": "电脑", "min": 3000, "max": 8000, "kw": "轻薄本", ... }
}

返回体里的 template_output 就是最终发给引擎的 JSON，方便在 Kibana 里二次验证。

3.8.5 高级语法速查

场景	示例	渲染后
原样输出 JSON	`"filter": {{#toJson}}status_list{{/toJson}}`	`"filter": ["paid","shipped"]`
数组循环	`"{{#fields}}\"{{.}}\"{{^last}},{{/last}}{{/fields}}"`	`"title","price","sold"`
缺省值	`"{{default_size}}{{^default_size}}10{{/default_size}}"`	10
反向节	`"{{^vip}}\"sort\":[{\"_score\":\"desc\"}]{{/vip}}"`	非会员才按相关度排序