字段上下文编辑

使用 Painless 脚本创建 脚本字段,为查询结果中的每个文档返回自定义值。

变量

params (Map, 只读)
作为查询的一部分传递的用户定义参数。
doc (Map, 只读)
包含指定文档的字段,其中每个字段都是一个 List 值。
params['_source'] (Map, 只读)
包含存储文档中存在的字段的 MapList 结构中的提取 JSON。

返回

对象
每个文档的自定义值。

API

标准 Painless API专用字段 API 都可用。

示例

要运行此示例,请先按照 上下文示例 中的步骤操作。

然后,您可以使用这两个示例脚本计算每个搜索匹配项的自定义信息,并将其输出到两个新字段。

第一个脚本获取 datetime 字段的文档值,并调用 getDayOfWeekEnum 函数以确定相应的星期几。

doc['datetime'].value.getDayOfWeekEnum().getDisplayName(TextStyle.FULL, Locale.ROOT)

第二个脚本计算演员数量。演员姓名存储在 actors 字段中的关键字数组中。

doc['actors'].size()  

默认情况下,text 字段不可用文档值。如果 actors 是一个 text 字段,您仍然可以通过 params['_source']['actors'].size()_source 中提取值来计算演员数量。

以下请求返回计算出的星期几和出现在每部戏剧中的演员数量

GET seats/_search
{
  "size": 2,
  "query": {
    "match_all": {}
  },
  "script_fields": {
    "day-of-week": {
      "script": {
        "source": "doc['datetime'].value.getDayOfWeekEnum().getDisplayName(TextStyle.FULL, Locale.ROOT)"
      }
    },
    "number-of-actors": {
      "script": {
        "source": "doc['actors'].size()"
      }
    }
  }
}
{
  "took" : 68,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 11,
      "relation" : "eq"
    },
    "max_score" : 1.0,
    "hits" : [
      {
        "_index" : "seats",
        "_id" : "1",
        "_score" : 1.0,
        "fields" : {
          "day-of-week" : [
            "Thursday"
          ],
          "number-of-actors" : [
            4
          ]
        }
      },
      {
        "_index" : "seats",
        "_id" : "2",
        "_score" : 1.0,
        "fields" : {
          "day-of-week" : [
            "Thursday"
          ],
          "number-of-actors" : [
            1
          ]
        }
      }
    ]
  }
}