来源: 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字段

脚本

Untitled

本文只介绍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终点存储在集群状态并从集群状态中检索。

自动脚本重载