SUM - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A SUM função calcula a soma dos valores na expressão.

Sintaxe

SUM(<numeric_expr>)

Arguments

	Description
numeric_expr	Uma expressão numérica para somar.

Tipos de devolução

Devolve um valor escalar numérico.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Considere este conjunto de exemplos de documentos dentro da Products coleção para esses exemplos.

[
  {
    "name": "Sathem Backpack",
    "quantity": 0,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Ventrin Backpack",
    "quantity": 230,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Martox Backpack",
    "quantity": 14,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Rangeo Backpack",
    "quantity": 232,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Moonroq Backpack",
    "quantity": 141,
    "detailCategory": "gear-hike-backpacks"
  }
]

Somar valores para uma única propriedade

Neste exemplo, a SUM função é usada para somar os quantity valores da propriedade em um único valor agregado.

SELECT VALUE
  SUM(p.quantity)
FROM
  products p
WHERE
  p.detailCategory = "gear-hike-backpacks"

[
  617
]

Observações

• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices 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.