只要是Elasticsearch API中支持脚本的地方，语法都遵循相同的模式：

  "script": {
    "lang":   "...",  
    "source" | "id": "...", 
    "params": { ... } 
  }

例如，下面的脚本在搜索请求中用于返回脚本字段(scripted field)：

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

GET my_index/_search
{
  "script_fields": {
    "my_doubled_field": {
      "script": {
        "lang":   "expression",
        "source": "doc['my_field'] * multiplier",
        "params": {
          "multiplier": 2
        }
      }
    }
  }
}

脚本参数

  "source": "doc['my_field'] * 2"

  "source": "doc['my_field'] * multiplier",
  "params": {
    "multiplier": 2
  }

短脚本形式(short script form)

为了简洁，可以使用简短的脚本形式。 短形式下，script由字符串而不是对象表示。 该字符串包含脚本的源(source)。

脚本的简短形式：

  "script": "ctx._source.likes++"

而相同脚本的一般形式是：

  "script": {
    "source": "ctx._source.likes++"
  }

存储的脚本

可以使用_scripts终端在集群状态中存储和检索脚本。

如果启用了Elasticsearch安全功能，你必须拥有以下权限才能创建、检索和删除存储的脚本：

有关更多信息，请参见安全权限。

请求示例

下面是一个使用位于/_scripts/{id}的存储脚本的示例。

首先，在集群状态中创建名为calculate-score的脚本：

POST _scripts/calculate-score
{
  "script": {
    "lang": "painless",
    "source": "Math.log(_score * 2) + params.my_modifier"
  }
}

你还可以指定一个上下文作为url路径的一部分，以/_scripts/{id}/{context}的形式根据该特定上下文编译存储的脚本：

POST _scripts/calculate-score/score
{
  "script": {
    "lang": "painless",
    "source": "Math.log(_score * 2) + params.my_modifier"
  }
}

同样的脚本可以通过以下方式检索：

GET _scripts/calculate-score

可以通过指定参数id来使用存储的脚本，如下所示：

GET twitter/_search
{
  "query": {
    "script_score": {
      "query": {
        "match": {
            "message": "some message"
        }
      },
      "script": {
        "id": "calculate-score",
        "params": {
          "my_modifier": 2
        }
      }
    }
  }
}

删除脚本：

DELETE _scripts/calculate-score

搜索模板(search templates)

还可以使用_scripts API来存储搜索模板(search templates)。 搜索模板保存带有占位符值(称为模板参数)的特定搜索请求。

你可以使用存储的搜索模板来运行搜索，而无需写出整个查询。 只需提供存储模板的ID和模板参数。 当你希望快速无误地运行常用查询时，这很有用。

搜索模板使用mustache模板语言。 更多详情和示例请参见搜索模板。

脚本缓存

默认情况下，所有脚本都会被缓存，它们只需要在变更时重新编译。 默认情况下，脚本没有过期时间，但是你可以通过使用script.cache.expire设置来更改此行为。 可以使用script.cache.max_size设置来配置此缓存的个数。 默认情况下，缓存的脚本的个数为100。

脚本错误

当存在编译或运行时异常时，Elasticsearch会返回错误的详细信息。 此响应的内容有助于跟踪问题。

position的内容是实验性的，可能会发生变化。