SOMA (consulta NoSQL)

APLICA-SE A: NoSQL

Retorna a soma dos valores na expressão.

Sintaxe

SUM(<numeric_expr>)  

Argumentos

Description
numeric_expr Uma expressão numérica.

Tipos de devolução

Retorna uma expressão numérica.

Exemplos

Para este exemplo, considere um contêiner com vários itens que podem conter um quantity campo.

[
  {
    "name": "Cosmoxy pack",
    "quantity": 35,
    "category": "hiking-bags"
  },
  {
    "name": "Heliont pack",
    "category": "hiking-bags"
  },
  {
    "name": "Immery bag",
    "quantity": 15,
    "category": "hiking-bags"
  }
]

A SUM função é usada para somar os valores do quantity campo, quando ele existe, em um único valor agregado.

SELECT VALUE
    SUM(p.quantity)
FROM 
    products p
WHERE
    p.category = "hiking-bags"
[
  50
]

Observações

  • Esta função beneficia de um índice de intervalo.
  • Se algum argumento for SUM string, booleano ou null, toda a função do sistema agregado retornará undefined.
  • Se qualquer argumento individual tiver um undefined valor, esse valor não será incluído no SUM cálculo.