elasticsearch-script-velocity 8.11.0-1.0.0 发布

Search Template 是 Elasticsearch 中一项非常实用的功能。通过这一特性，搜索请求的查询结构可以事先定义好，然后在实际请求时传入搜索参数。这样既使得请求体更加简洁，也避免了在客户端拼接查询结构时可能出现的错误。

在需要进行搜索调优时，可以直接在 Elasticsearch 服务端修改搜索脚本，而无需重新发布客户端。这显著提高了搜索调优的效率。

然而，Elasticsearch 默认支持的脚本语言（mustache/painless/expression）的语法逻辑相对较为有限，不支持逻辑判断，从而对 Search Template 的使用带来了一定的限制。

通过引入 Velocity 到 Elasticsearch 中，可以支持任何逻辑判断，使得 Search Template 的使用更加灵活。这为用户提供了更强大、更灵活的搜索定制能力。

更新内容 🎉 🎉 🎉

支持 ElasticSearch v8.11.0 版本

• 依赖: 更新 elasticsearch 版本 v8.11.0
• 测试: 提升单元测试覆盖率
• 测试: 添加JMH基准测试
• 重构：修改版本号发布策略（version=elasticsearchVersion-pluginVersion）

安装

方式 1 - 使用 elasticsearch-plugin  安装

 ./bin/elasticsearch-plugin install https://github.com/Ahoo-Wang/elasticsearch-script-velocity/releases/download/v8.11.0/elasticsearch-script-velocity-8.11.0.zip 

方式 2 - 从 Releases 下载构建包

1. 创建插件目录 cd your-es-root/plugins/ && mkdir elasticsearch-script-velocity
2. 解压到该目录 your-es-root/plugins/elasticsearch-script-velocity

使用

存储脚本

create-stored-script-api

 POST _scripts/templateid { "script": { "lang": "velocity", "source": { "query": { "match": { "title": "$query_string" } } } } }

获取已存储的脚本

get-stored-script-api

 GET _scripts/templateid

请求响应结果：

 { "_id": "templateid", "found": true, "script": { "lang": "velocity", "source": """{"query":{"match":{"title":"$query_string"}}}""", "options": { "content_type": "application/json;charset=utf-8" } } }

删除已存储的脚本

delete-stored-script-api

 DELETE _scripts/templateid

模板搜索

search-template

 GET _search/template { "id": "templateid", "params": { "query_string": "search for these words" } }

验证搜索模板

 GET _render/template/templateid { "params": { "query_string": "search for these words" } }

请求响应结果：

 { "template_output": { "query": { "match": { "title": "search for these words" } } } }