最大值聚合
max
度量是一种单值度量,它返回字段的最大值。
max
聚合使用 double
(双精度)表示来比较数字字段。对于包含大于 253 的 long
或 unsigned_long
整数值的字段,结果应视为近似值,因为 double
尾数中的有效位数为 53。
参数
max
聚合接受以下参数。
参数 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
field | 必需 | 字符串 | 计算最大值的字段名称。 |
missing | 可选 | 数值 | 分配给字段缺失实例的值。如果未提供,则包含缺失值的文档将从聚合中省略。 |
示例
以下示例请求在 OpenSearch 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
会返回此替换值作为最大值。