mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-09 22:45:04 +00:00
eed079aaac
* Make it clearer that `aggs` is an allowed synomym for the `aggregations` key * Fix broken example in for datehistogram, `1.5M` is not an allowed interval * Make use of colon before examples consistent * Fix typos
78 lines
2.2 KiB
Plaintext
78 lines
2.2 KiB
Plaintext
[[search-aggregations-metrics-sum-aggregation]]
|
|
=== Sum
|
|
|
|
A `single-value` metrics aggregation that sums up numeric values that are extracted from the aggregated documents. These values can be extracted either from specific numeric fields in the documents, or be generated by a provided script.
|
|
|
|
Assuming the data consists of documents representing stock ticks, where each tick holds the change in the stock price from the previous tick.
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"query" : {
|
|
"filtered" : {
|
|
"query" : { "match_all" : {}},
|
|
"filter" : {
|
|
"range" : { "timestamp" : { "from" : "now/1d+9.5h", "to" : "now/1d+16h" }}
|
|
}
|
|
}
|
|
},
|
|
"aggs" : {
|
|
"intraday_return" : { "sum" : { "field" : "change" } }
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The above aggregation sums up all changes in the today's trading stock ticks which accounts for the intraday return. The aggregation type is `sum` and the `field` setting defines the numeric field of the documents of which values will be summed up. The above will return the following:
|
|
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
...
|
|
|
|
"aggregations": {
|
|
"intraday_return": {
|
|
"value": 2.18
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The name of the aggregation (`intraday_return` above) also serves as the key by which the aggregation result can be retrieved from the returned response.
|
|
|
|
==== Script
|
|
|
|
Computing the intraday return based on a script:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
...,
|
|
|
|
"aggs" : {
|
|
"intraday_return" : { "sum" : { "script" : "doc['change'].value" } }
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
===== Value Script
|
|
|
|
Computing the sum of squares over all stock tick changes:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"aggs" : {
|
|
...
|
|
|
|
"aggs" : {
|
|
"daytime_return" : {
|
|
"sum" : {
|
|
"field" : "change",
|
|
"script" : "_value * _value" }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|