IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Metric aggregation reduce context Bucket selector aggregation context »
Elastic Docs ›Painless Scripting Language [7.9] ›Painless contexts

Bucket script aggregation context

edit

Bucket script aggregation context

edit

Use a Painless script in an bucket_script pipeline aggregation to calculate a value as a result in a bucket.

Variables

edit
params (Map, read-only)
User-defined parameters passed in as part of the query. The parameters include values defined as part of the buckets_path.

Return

edit
numeric
The calculated value as the result.

API

edit

The standard Painless API is available.

Example

edit

To run this example, first follow the steps in context examples.

The painless context in a bucket_script aggregation provides a params map. This map contains both user-specified custom values, as well as the values from other aggregations specified in the buckets_path property.

This example takes the values from a min and max aggregation, calculates the difference, and adds the user-specified base_cost to the result:

(params.max - params.min) + params.base_cost

Note that the values are extracted from the params map. In context, the aggregation looks like this:

GET /seats/_search
{
  "size": 0,
  "aggs": {
    "theatres": {
      "terms": {
        "field": "theatre",
        "size": 10
      },
      "aggs": {
        "min_cost": {
          "min": {
            "field": "cost"
          }
        },
        "max_cost": {
          "max": {
            "field": "cost"
          }
        },
        "spread_plus_base": {
          "bucket_script": {
            "buckets_path": { 
              "min": "min_cost",
              "max": "max_cost"
            },
            "script": {
              "params": {
                "base_cost": 5 
              },
              "source": "(params.max - params.min) + params.base_cost"
            }
          }
        }
      }
    }
  }
}

The buckets_path points to two aggregations (min_cost, max_cost) and adds min/max variables to the params map

The user-specified base_cost is also added to the script’s params map
« Metric aggregation reduce context Bucket selector aggregation context »