在Elasticsearch（ES）的日常开发和运维中，我们经常会遇到需要频繁执行相似查询的场景。这些查询可能因业务逻辑的复杂性而涉及多个字段、过滤条件和聚合分析。为了优化这些操作，提高开发效率，Elasticsearch提供了搜索模板（Search Templates）的功能。本文将介绍如何使用Elasticsearch的搜索模板来重用和共享查询。

一、为什么使用搜索模板

在日常开发中，尽管大多数查询可能相对简单，但在一些复杂的业务场景（如金融、医药等）中，一次搜索可能需要传入或返回几十个字段，同时涉及复杂的过滤条件和聚合分析。此时，手动编写每个查询不仅效率低下，还容易出错。搜索模板就像MySQL中的存储过程或函数，只需定义一次，后续在代码中通过调用模板并传递参数即可完成搜索功能，极大地提高了开发效率和查询的灵活性。

二、搜索模板的入门案例

2.1 标准形式

搜索模板的基本形式是定义一个包含查询条件的JSON对象，并通过_search/template API调用。例如：

GET /index_name/_search/template
{
  "source": {
    "query": {
      "match": {
        "remark": "{{kw}}"
      }
    },
    "size": "{{size}}"
  },
  "params": {
    "kw": "真正的数值",
    "size": 100
  }
}

在这个例子中，{{kw}}和{{size}}是模板中的变量，通过params对象传递具体的值。

2.2 toJSON形式

toJSON形式的特点在于source使用字符串来定义，且需要用到转义字符。例如：

GET cars/_search/template
{
  "source": "{ \"query\": { \"match\": {{#toJson}}parameter{{/toJson}} }}",
  "params": {
    "parameter": {
      "remark": "真正的数值"
    }
  }
}

2.3 join方法传参

使用join方法可以将数组中的元素拼接成字符串，用于查询条件。例如：

GET index_name/_search/template
{
  "source": {
    "query": {
      "match": {
        "remark": "{{#join delimiter=' '}}kw{{/join delimiter=' '}}"
      }
    }
  },
  "params": {
    "kw": ["大众", "标致", "奔驰", "宝马"]
  }
}

2.4 默认值形式

在模板中可以为参数设置默认值，如果调用时没有传递该参数，则使用默认值。例如：

GET index_name/_search/template
{
  "source": {
    "query": {
      "range": {
        "price": {
          "gte": "{{start}}",
          "lte": "{{end}}{{^end}}200000{{/end}}"
        }
      }
    }
  },
  "params": {
    "start": 100000
  }
}

三、记忆template并实现重复调用

3.1 Elasticsearch保存template

为了重用模板，我们可以将其保存在Elasticsearch中。通过指定模板的名称，方便后续反复调用。例如：

POST _scripts/my_test_template
{
  "script": {
    "lang": "mustache",
    "source": {
      "query": {
        "match": {
          "field_name": "{{kw}}"
        }
      }
    }
  }
}

3.2 调用template

调用模板时，通过id来指定具体的模板，并传递相应的参数。例如：

GET index_name/_search/template
{
  "id": "my_test_template",
  "params": {
    "kw": "自定义template的参数值"
  }
}

3.3 查询已定义的template

通过GET请求可以查询已定义的模板信息，例如：

GET _scripts/my_test_template

3.4 删除已定义的template

如果需要删除已定义的模板，可以使用DELETE请求，例如：

DELETE _scripts/my_test_template

四、搜索模板的高级应用

4.1 验证模板

Elasticsearch提供了_render/template API来验证模板。