SUM - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La SUM fonction calcule la somme des valeurs dans l’expression.

Syntaxe

SUM(<numeric_expr>)

Arguments

Types de retour

Retourne une valeur scalaire numérique.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Considérez cet exemple de jeu de documents dans la Products collection pour ces exemples.

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

Somme des valeurs pour une propriété unique

Dans cet exemple, la SUM fonction est utilisée pour additionner les valeurs de la quantity propriété en une seule valeur agrégée.

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

[
  617
]

Remarques

• Cette fonction tire parti de l’utilisation d’un index de plage. Pour plus d’informations, consultez les index de plage.
• Si des arguments sont SUM des arguments de chaîne, booléen ou null ; la fonction système d’agrégation entière retourne undefined.
• Si un argument individuel a une undefined valeur, cette valeur n’est pas incluse dans le SUM calcul.