SUM - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La SUM función calcula la suma de los valores de la expresión.

Syntax

SUM(<numeric_expr>)

Arguments

	Description
numeric_expr	Expresión numérica que se va a sumar.

Tipos de retorno

Devuelve un valor escalar numérico.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Considere este conjunto de documentos de ejemplo dentro de la Products colección para estos ejemplos.

[
  {
    "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"
  }
]

Suma de valores para una sola propiedad

En este ejemplo, la SUM función se usa para sumar los valores de la quantity propiedad en un único valor agregado.

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

[
  617
]

Observaciones

• Esta función se beneficia del uso de un índice de intervalo. Para obtener más información, vea Índices de intervalo.
• Si alguno de los argumentos de SUM son string, boolean o null; toda la función del sistema de agregado devuelve undefined.
• Si algún argumento individual tiene un undefined valor, ese valor no se incluye en el SUM cálculo.