Share via


SUM (requête NoSQL)

S’APPLIQUE À : NoSQL

Renvoie la somme de toutes les valeurs dans l’expression.

Syntaxe

SUM(<numeric_expr>)  

Arguments

Description
numeric_expr Expression numérique.

Types de retour

Renvoie une expression numérique.

Exemples

Pour cet exemple, prenons l’exemple d’un conteneur avec plusieurs éléments pouvant contenir un champ quantity.

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

La fonction SUM est utilisée pour additionner les valeurs du champ quantity, lorsqu’il existe, en une seule valeur agrégée.

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

Remarques

  • Cette fonction bénéficie d’un index de plage.
  • Si des arguments dans SUM sont de type chaîne, booléen ou nul, l’ensemble de la fonction système agrégée retourne undefined.
  • Si un argument individuel a une valeur undefined, cette valeur n’est pas incluse dans le calcul SUM.