最大值聚合

max 指标是一个单值指标，它返回字段的最大值。

max 聚合使用 double（双精度）表示法比较数字字段。对于包含大于 2⁵³ 的 long 或 unsigned_long 整数值的字段，结果应视为近似值，因为 double 尾数的有效位数为 53。

参数

max 聚合接受以下参数。

参数	必填/可选	数据类型	描述
field	必填	字符串	要计算最大值的字段名称。
missing	可选	数值	为字段缺失实例分配的值。如果未提供，则包含缺失值的文档将从聚合中省略。

示例

以下示例请求在 UDB-SX Dashboards 电子商务示例数据中查找最昂贵的商品——即 base_unit_price 值最大的商品：

GET opensearch_dashboards_sample_data_ecommerce/_search
{
  "size": 0,
  "aggs": {
    "max_base_unit_price": {
      "max": {
        "field": "products.base_unit_price"
      }
    }
  }
}

示例响应

如下示例响应所示，聚合返回 products.base_unit_price 的最大值：

{
  "took": 24,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 4675,
      "relation": "eq"
    },
    "max_score": null,
    "hits": []
  },
  "aggregations": {
    "max_base_unit_price": {
      "value": 540
    }
  }
}

您可以使用聚合名称 (max_base_unit_price) 作为键从响应中检索聚合结果。

缺失值

您可以为聚合字段的缺失实例分配一个值。有关更多信息，请参阅缺失值聚合。

默认情况下，max 会忽略缺失值。如果您使用 missing 分配了一个大于任何现有值的值，则 max 会将此替换值作为最大值返回。