SUM (consulta NoSQL)
APLICA-SE A: NoSQL
Retorna a soma dos valores na expressão.
Sintaxe
SUM(<numeric_expr>)
Argumentos
Descrição | |
---|---|
numeric_expr |
Uma expressão numérica. |
Tipos de retorno
Retorna uma expressão numérica.
Exemplos
Para este exemplo, considere um contêiner com vários itens que podem conter um campo quantity
.
[
{
"name": "Cosmoxy pack",
"quantity": 35,
"category": "hiking-bags"
},
{
"name": "Heliont pack",
"category": "hiking-bags"
},
{
"name": "Immery bag",
"quantity": 15,
"category": "hiking-bags"
}
]
A função SUM
é usada para somar os valores do campo quantity
, quando ele existe, em um único valor agregado.
SELECT VALUE
SUM(p.quantity)
FROM
products p
WHERE
p.category = "hiking-bags"
[
50
]
Comentários
- Esta função se beneficia de um índice de intervalo.
- Se algum argumento em
SUM
for do tipo string, booleano ou nulo, toda a função do sistema agregado retornaráundefined
. - Se algum argumento individual tiver um valor
undefined
, esse valor não será incluído no cálculoSUM
.