› › ›

Агрегация min_bucket

Вспомогательная агрегация, которая определяет корзину(ы) с минимальным значением указанного метрического показателя в связанной агрегации и выводит как значение, так и ключ(и) корзины(ы). Указанный метрический показатель должен быть числовым, а связанная агрегация — агрегацией по нескольким корзинам.

Синтаксис

Агрегация min_bucket выглядит следующим образом:

{
  "min_bucket": {
    "buckets_path": "the_sum"
  }
}

Таблица 58. min_bucket Параметры

Имя параметра	Описание	Обязательно	Значение по умолчанию
`buckets_path`	Путь к корзинам, для которых мы хотим найти минимальное значение (см. `buckets_path` Синтаксис для получения дополнительной информации)	Обязательно
`gap_policy`	Политика, применяемая при обнаружении пробелов в данных (см. Обработка пробелов в данных для получения дополнительной информации)	Необязательно	`skip`
`format`	формат, применяемый к выходному значению этой агрегации	Необязательно	`null`

Следующий фрагмент вычисляет минимум суммарных ежемесячных sales:

POST /sales/_search
{
  "size": 0,
  "aggs": {
    "sales_per_month": {
      "date_histogram": {
        "field": "date",
        "calendar_interval": "month"
      },
      "aggs": {
        "sales": {
          "sum": {
            "field": "price"
          }
        }
      }
    },
    "min_monthly_sales": {
      "min_bucket": {
        "buckets_path": "sales_per_month>sales" 
      }
    }
  }
}

buckets_path сообщает этой агрегации min_bucket, что нам нужно минимальное значение агрегации sales в гистограмме дат sales_per_month.

И вот возможный ответ:

{
   "took": 11,
   "timed_out": false,
   "_shards": ...,
   "hits": ...,
   "aggregations": {
      "sales_per_month": {
         "buckets": [
            {
               "key_as_string": "2015/01/01 00:00:00",
               "key": 1420070400000,
               "doc_count": 3,
               "sales": {
                  "value": 550.0
               }
            },
            {
               "key_as_string": "2015/02/01 00:00:00",
               "key": 1422748800000,
               "doc_count": 2,
               "sales": {
                  "value": 60.0
               }
            },
            {
               "key_as_string": "2015/03/01 00:00:00",
               "key": 1425168000000,
               "doc_count": 2,
               "sales": {
                  "value": 375.0
               }
            }
         ]
      },
      "min_monthly_sales": {
          "keys": ["2015/02/01 00:00:00"], 
          "value": 60.0
      }
   }
}

keys представляет собой массив строк, так как минимальное значение может присутствовать в нескольких корзинах

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/search-aggregations-pipeline-min-bucket-aggregation.html