# 擴展統計聚合 多值度量聚合計算從匯總文檔中提取的數值的統計數據。這些值可以從文檔中的特定數值字段中提取，也可以由提供的腳本生成。 擴展統計聚合是統計聚合（[`stats`](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/search-aggregations-metrics-stats-aggregation.html "Stats Aggregation")?aggregation）的擴展版本，其中額外添加如`sum_of_squares`,?`variance`,?`std_deviation`?and?`std_deviation_bounds。` 假設數據由學生的考試成績（0到100）組成： | `{?` `"aggs"`?`: {?` `"grades_stats"`?`: {?` `"extended_stats"`?`: {?` `"field"`?`:?``"grade"`? `}?` `}?` `}?` `}` | 上述聚合計算所有文檔的分數統計信息。聚合類型為extended_stats，設置文檔的數字字段為需要統計的字段為grade，執行上面的語句將返回如下： | `{` `...` `"aggregations"``: {` `"grade_stats"``: {` `"count"``:?``9``,` `"min"``:?``72``,` `"max"``:?``99``,` `"avg"``:?``86``,` `"sum"``:?``774``,` `"sum_of_squares"``:?``67028``,` `"variance"``:?``51.55555555555556``,` `"std_deviation"``:?``7.180219742846005``,` `"std_deviation_bounds"``: {` `"upper"``:?``100.36043948569201``,` `"lower"``:?``71.63956051430799` `}` `}` `}` `}` | 聚合的名稱（上面語句中的grades_stats）作為key，通過該key可以從返回的結果中檢索出聚集的結果。 ## Standard Deviation Bounds 默認情況下，擴展統計度量將返回一個對象稱為std_deviation_bounds，它提供了平均值加/減兩個標準差的區間。這可以成為一個用來方式來可視化數據的方差。如果你想要一個不同的邊界，例如三個標準偏差，你可以在請求中設置： | `{` `"aggs"`?`: {` `"grades_stats"`?`: {` `"extended_stats"`?`: {` `"field"`?`:?``"grade"``,` `"sigma"`?`:?``3` `}` `}` `}` `}` | 注釋1.sigma控制應顯示多少標準偏差+/-平均值。 sigma可以是任何非負double類型數字，這意味著你可以要求非整數值，如1.5。值為0也是有效的，但只會返回上下限的平均值。 提示：默認情況下顯示標準偏差和其邊界，但它們并不總是適用于所有的數據集。您的數據必須是正常分布的度量才有意義。標準偏差背后的統計數據假設為正常分布的數據，因此如果數據偏斜向左或向右，返回的值將是誤導性的。 ## Script 使用下面的腳本計算成績的統計信息： | `{` `...,` `"aggs"`?`: {` `"grades_stats"`?`: {` `"extended_stats"`?`: {` `"script"`?`: {` `"inline"`?`:?``"doc['grade'].value"``,` `"lang"`?`:?``"painless"` `}` `}` `}` `}` `}` | This will interpret the?`script`?parameter as an?`inline`?script with the?`painless`?script language and no script parameters. 用下面的語法來使用腳本文件： | `{` `...,` `"aggs"`?`: {` `"grades_stats"`?`: {` `"extended_stats"`?`: {` `"script"`?`: {` `"file"``:?``"my_script"``,` `"params"``: {` `"field"``:?``"grade"` `}` `}` `}` `}` `}` `}` | 提示：可以使用id參數代替file參數來使用index的腳本。 ## Value Script 當考試的難度是高于學生的水平，需要校正學生的成績，我們可以使用value script獲得新的統計： | `{` `"aggs"`?`: {` `...` `"aggs"`?`: {` `"grades_stats"`?`: {` `"extended_stats"`?`: {` `"field"`?`:?``"grade"``,` `"script"`?`: {` `"lang"`?`:?``"painless"``,` `"inline"``:?``"_value * params.correction"``,` `"params"`?`: {` `"correction"`?`:?``1.2` `}` `}` `}` `}` `}` `}` `}` | ## Missing Value missing參數定義了如何處理缺少值的文檔。 默認情況下如果沒有指定的字段，這種文檔將被忽略，但也可以認為它們具有指定的值： | `{` `"aggs"`?`: {` `"grades_stats"`?`: {` `"extended_stats"`?`: {` `"field"`?`:?``"grade"``,` `"missing"``:?``0` `}` `}` `}` `}` | 注釋1:文檔中如果沒有grade這個字段，則認為該字段的值是0。