elasticsearch painless脚本

来源： https://www.elastic.co/guide/en/elasticsearch/reference/6.5/modules-scripting-fields.html#_search_and_aggregation_scripts
https://www.elastic.co/guide/en/elasticsearch/painless/6.5/painless-examples.html
前半部分用的es版本是5.5，script中是inline字段
后半部分用的es版本是6.5，script中是source字段

脚本

语言	沙盒	所需插件
painless	yes	内置
groovy	no	内置
javascript	no	lang-javascript
python	no	lang-javascript
语言	沙盒	所需插件

本文只介绍painless和JavaAPI

语法模式

 "script": {
 	"lang": "...", （1）
	"inline" | "stored" | "file": "...", （2）
	"params": { ... } （3）
}

（1）写入脚本的语言，默认为painless。
（2）脚本可以指定为 inline, stored, or file.
（3）传递给脚本的命名参数。

简单实例测试：

PUT my_index/my_type/1
{
	"my_field": 5
}

GET my_index/_search
{
  "script_fields": {
    "my_doubled_field": {
      "script": {
        "lang": "expression",
        "inline": "doc['my_field'] * multiplier",
        "params": {
          "multiplier": 2
        }
      }
    }
  }
}
//结果
{
  "took": 176,
  "timed_out": false,
  "_shards": {
    "total": 5,
    "successful": 5,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": 1,
    "max_score": 1.0,
    "hits": [
      {
        "_index": "my_index",
        "_type": "my_type",
        "_id": "1",
        "_score": 1.0,
        "fields": {
          "my_doubled_field": [
            10.0
          ]
        }
      }
    ]
  }
}

参数

lang

指定脚本写入的语言，你可以设置任何脚本语言，可以通过改变config 文件下 elasticsearch.yml 设置成script.default_lang 合适的语言

inline, stored, file

指定脚本的源 inline脚本入上面eg所示 stored 指定存储在集群(see Stored Scripts 超连接)并从config / scripts目录中的文件检索文件脚本（请参阅文件脚本）。
虽然众多表达式和painless 语言可以作为inline或存储的脚本配置即可用，但其他例如groovy的语言只能被指定为文件，除非您首先调整默认的脚本安全设置。

params

指定作为变量传递到脚本中的任何命名参数
ps:如果您需要将变量传递到脚本中，那么您应该将它们作为命名参数传递，而不是将其转换为脚本本身的编码

//错误写法！！！！！
"inline": "doc['my_field'] * 2"
//命名参数传递：
"inline": "doc['my_field'] * multiplier",
"params": {
"multiplier": 2
}

脚本存储

脚本可以使用_scripts终点存储在集群状态并从集群状态中检索。

自动脚本重载

脚本目录将每60秒重新扫描一次（可以使用resource.reload.interval设置进行配置），新脚本，已更改或已删除的脚本将从脚本缓存中进行编译，更新或删除。<