Elasticsearch 7.9.3中如何编写多行脚本？

Elasticsearch的Painless脚本天然支持多行写法，以下是几种常见场景的具体实现方式：

1. 请求体中直接编写多行脚本 #

在_update、_update_by_query这类API中，直接用三重引号（"""）包裹多行脚本内容即可，还能添加注释提升可读性：

POST /my_index/_update/1
{
  "script": {
    "lang": "painless",
    "source": """
      // 多行脚本：更新计数字段并添加更新时间
      def current_count = ctx._source.count ?: 0;
      ctx._source.count = current_count + 1;
      ctx._source.last_updated = new Date();
    """
  }
}

2. 上传存储式多行脚本 #

如果脚本逻辑复杂、需要复用，可先将多行脚本上传到Elasticsearch的脚本存储中：

上传脚本 #

POST _scripts/increment_with_timestamp
{
  "script": {
    "lang": "painless",
    "source": """
      def base_count = ctx._source.count ?: 0;
      ctx._source.count = base_count + params.increment;
      ctx._source.last_modified = new Date();
    """
  }
}

调用存储的脚本 #

POST /my_index/_update/1
{
  "script": {
    "id": "increment_with_timestamp",
    "params": {
      "increment": 2
    }
  }
}

3. 查询场景中的多行脚本 #

在function_score、script_fields等查询场景中，同样可以用多行脚本实现复杂逻辑：

POST /my_index/_search
{
  "query": {
    "function_score": {
      "query": {"match_all": {}},
      "functions": [
        {
          "script_score": {
            "script": {
              "source": """
                // 根据字段权重计算得分
                def total_score = 0;
                if (ctx._source.view_count > 1000) {
                  total_score += 5;
                }
                if (ctx._source.is_featured) {
                  total_score += 3;
                }
                return total_score;
              """
            }
          }
        }
      ]
    }
  }
}

注意事项 #

• 多行脚本需保证Painless语法正确，注意分号、括号的闭合，语法规则和Java接近
• 在Kibana Dev Tools中编写时，三重引号包裹的内容会被自动识别为多行字符串，换行和缩进不影响执行
• 7.9.3版本完全支持上述写法，官方文档虽未单独标注"多行脚本"章节，但本质是将脚本内容以多行字符串形式传入，只要字符串格式正确即可生效

内容的提问来源于stack exchange，提问作者JULURI SAICHANDU