重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 当前版本文档。
Elasticsearch 权威指南 [7.7] » 聚合 » 度量聚合 » min 聚合
« max 聚合 median_absolute_deviation 聚合 »

min 聚合

single-value(单值) 度量聚合，跟踪并返回从聚合文档中提取的数值的最小值。 这些值可以从文档中指定的 numeric 字段中提取，也可以由提供的脚本生成。

min 和 max 聚合对数据以 double(双精度) 进行操作。 因此，在绝对值大于 2^53 的长整型上运行时，结果可能是近似的。

计算所有文档的最低价格(min_price)：

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

响应：

{
    ...

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

可以看到，聚合的名称(上面的min_price)也作为键，通过它可以从返回的响应中检索聚合结果。

脚本(script)

min 聚合还可以计算脚本的最小值。以下示例计算最低价格： 

POST /sales/_search
{
    "aggs" : {
        "min_price" : {
            "min" : {
                "script" : {
                    "source" : "doc.price.value"
                }
            }
        }
    }
}

这将使用 painless(无痛) 脚本语言，没有脚本参数。 要使用存储的脚本，请使用以下语法： 

POST /sales/_search
{
    "aggs" : {
        "min_price" : {
            "min" : {
                "script" : {
                    "id": "my_script",
                    "params": {
                        "field": "price"
                    }
                }
            }
        }
    }
}

值脚本 (Value Script)

假设索引中的文档价格以美元为单位，但是我们想以欧元计算最小值(这个例子中，假设兑换率是1.2)。 我们可以使用值脚本，在汇总每个值之前对其应用转换率(conversion_rate)： 

POST /sales/_search
{
    "aggs" : {
        "min_price_in_euros" : {
            "min" : {
                "field" : "price",
                "script" : {
                    "source" : "_value * params.conversion_rate",
                    "params" : {
                        "conversion_rate" : 1.2
                    }
                }
            }
        }
    }
}

缺失的值

参数 missing 定义应该如何处理有缺失值的文档。 默认情况下，它们将被忽略，但也可以将它们视为有一个值。 

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

grade 字段没有值的文档将与值为10的文档落入同一个桶中。

« max 聚合 median_absolute_deviation 聚合 »