SUM (consulta NoSQL)

Artigo
02/27/2024

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álculo SUM.