Painless execute API 允许执行任意脚本并返回结果。请注意的是：这个 API 是新的，请求方式及响应在未来可能会有所改变。

Context

Context 也即是上下文的意思。Context 控制了脚本如何执行，在运行时可以使用哪些变量，返回类型是什么。

Plainless test context

这是默认的 context。painless_test 上下文按原样执行脚本，并且不添加任何特殊参数。 唯一可用的变量是 params，可用于访问用户定义的值。 脚本的结果总是转换为字符串。 如果未指定上下文，则默认使用此上下文。

例子

我们发送如下的请求：

[code]POST /_scripts/painless/_execute
{
"script": {
"source": "params.count / params.total",
"params": {
"count": 100.0,
"total": 1000.0
}
}
}

上面的响应结果为：

[code]{
"result": "0.1"
}

在上面，我们通过 params 把参数传入到 source 里进行执行，并返回结果。

Filter context

filter 上下文执行脚本的方式就像在脚本查询中执行脚本一样。 为了进行测试，必须提供一个文档，以便可以在内存中对其进行临时索引并可以从脚本中对其进行访问。 更准确地说，此类文档的 _source，存储的字段和 doc 值可用于正在测试的脚本。

可以在 context_setup 中为过滤器上下文指定以下参数：

• document：包含将在内存中临时建立索引并可以从脚本访问的文档。
• index：索引名称，其中包含与要编制索引的文档兼容的映射。

例子

[code]PUT /my-index-000001
{
"mappings": {
"properties": {
"field": {
"type": "keyword"
}
}
}
}

POST /_scripts/painless/_execute
{
"script": {
"source": "doc['field'].value.length() <= params.max_length",
"params": {
"max_length": 4
}
},
"context": "filter",
"context_setup": {
"index": "my-index-000001",
"document": {
"field": "four"
}
}
}

响应：

[code]{
"result" : true
}

在上面，我们首先定义了一个叫做 my-index-000001 的索引。由于我们使用了 filter 上下文，我们通过 context_setup 把相应的 index 及 document 进行定义。

Score context

Ccore 上下文将执行脚本，就像在 function_score 查询中的 script_score 函数中执行脚本一样。

可以在 context_setup 中为得分上下文指定以下参数：

• document：包含将在内存中临时建立索引并可以从脚本访问的文档。
• index：索引名称，其中包含与要编制索引的文档兼容的映射。
• query：如果在脚本中使用了 _score，则 query 可以指定它将用于计算分数。

例子

[code]PUT /my-index-000002
{
"mappings": {
"properties": {
"field": {
"type": "keyword"
},
"rank": {
"type": "long"
}
}
}
}

POST /_scripts/painless/_execute
{
"script": {
"source": "doc['rank'].value / params.max_rank",
"params": {
"max_rank": 5.0
}
},
"context": "score",
"context_setup": {
"index": "my-index-000002",
"document": {
"rank": 4
}
}
}

响应：

[code]{
"result" : 0.8
}

参考：

【1】https://www.elastic.co/guide/en/elasticsearch/painless/current/painless-execute-api.html