› › ›

Агрегация MIN

Агрегация метрик single-value, которая отслеживает и возвращает минимальное значение среди числовых значений, извлеченных из агрегированных документов.

Агрегации min и max работают с представлением данных double. Вследствие этого результат может быть приблизительным при работе с числами типа long, абсолютное значение которых больше 2^53.

Вычисление минимальной цены среди всех документов:

POST /sales/_search?size=0
{
  "aggs": {
    "min_price": { "min": { "field": "price" } }
  }
}

Ответ:

{
  ...

  "aggregations": {
    "min_price": {
      "value": 10.0
    }
  }
}

Как видно, имя агрегации (min_price выше) также служит ключом, по которому результат агрегации можно получить из возвращённого ответа.

Скрипт

Если вам нужно получить min чего-то более сложного, чем одного поля, выполните агрегацию на поле runtime.

POST /sales/_search
{
  "size": 0,
  "runtime_mappings": {
    "price.adjusted": {
      "type": "double",
      "script": """
        double price = doc['price'].value;
        if (doc['promoted'].value) {
          price *= 0.8;
        }
        emit(price);
      """
    }
  },
  "aggs": {
    "min_price": {
      "min": { "field": "price.adjusted" }
    }
  }
}

Пропущенное значение

Параметр missing определяет, как должны обрабатываться документы, у которых отсутствует значение. По умолчанию они игнорируются, но также можно рассматривать их так, как будто у них есть значение.

POST /sales/_search
{
  "aggs": {
    "grade_min": {
      "min": {
        "field": "grade",
        "missing": 10 
      }
    }
  }
}

Документы без значения в поле grade попадут в тот же бакет, что и документы, имеющие значение 10.

Поля гистограммы

Когда min вычисляется на полях гистограммы, результат агрегации — минимальное значение всех элементов в массиве values. Обратите внимание, что массив counts гистограммы игнорируется.

Например, для следующего индекса, хранящего предварительно агрегированные гистограммы с метриками задержки для разных сетей:

PUT metrics_index
{
  "mappings": {
    "properties": {
      "latency_histo": { "type": "histogram" }
    }
  }
}

PUT metrics_index/_doc/1?refresh
{
  "network.name" : "net-1",
  "latency_histo" : {
      "values" : [0.1, 0.2, 0.3, 0.4, 0.5],
      "counts" : [3, 7, 23, 12, 6]
   }
}

PUT metrics_index/_doc/2?refresh
{
  "network.name" : "net-2",
  "latency_histo" : {
      "values" :  [0.1, 0.2, 0.3, 0.4, 0.5],
      "counts" : [8, 17, 8, 7, 6]
   }
}

POST /metrics_index/_search?size=0&filter_path=aggregations
{
  "aggs" : {
    "min_latency" : { "min" : { "field" : "latency_histo" } }
  }
}

Агрегация min вернёт минимальное значение всех полей гистограммы:

{
  "aggregations": {
    "min_latency": {
      "value": 0.1
    }
  }
}

© 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-metrics-min-aggregation.html