Table des matières

Search

  1. Préface
  2. Le langage de transformation
  3. Constantes
  4. Opérateurs
  5. Variables
  6. Dates
  7. Fonctions

Transformation Language Reference

Transformation Language Reference

SUM

SUM

Renvoie la somme de toutes les valeurs dans le port sélectionné. Vous également pouvez appliquer un filtre pour limiter les lignes que vous lisez pour calculer le total. Vous pouvez imbriquer une seule autre fonction Agrégation dans SUM et la fonction imbriquée doit renvoyer un type de données numérique.

Syntaxe

SUM(
numeric_value
[,
filter_condition
] )
Le tableau suivant décrit les arguments de cette commande:
Argument
Obligatoire/
Facultatif
Description
numeric_value
Obligatoire
Type de données numérique. Transmet les valeurs que vous voulez ajouter. Vous pouvez entrer l'expression de transformation valide de votre choix. Vous pouvez utiliser des opérateurs pour ajouter des valeurs dans plusieurs ports.
filter_condition
Facultatif
Limite les lignes dans la recherche. La condition de filtre doit être une valeur numérique ou renvoyer TRUE, FALSE ou NULL. Vous pouvez entrer l'expression de transformation valide de votre choix.

Valeur de retour

Valeur numérique.
NULL si toutes les valeurs transmises à la fonction sont NULL, ou si aucune ligne n'est sélectionnée (par exemple : la condition de filtre renvoie FALSE ou NULL pour toutes les lignes).
Si la valeur de retour est décimale avec une précision supérieure à 15, vous pouvez activer la précision élevée pour garantir une précision décimale jusqu'à 28 chiffres.

Valeurs nulles

Si une seule valeur est nulle, SUM l'ignore. Cependant, si toutes les valeurs transmises à partir du port sont NULL, SUM renvoie NULL.

Grouper par

SUM regroupe des valeurs en fonction du groupement par ports que vous définissez dans la transformation et renvoie un résultat pour chaque groupe.
S'il n'existe aucun port de regroupement, SUM traite toutes les lignes comme un groupe et renvoie une valeur.

Exemple

L'expression suivante renvoie la somme de toutes les valeurs supérieures à 2000 dans le port Sales :
SUM( SALES, SALES > 2000 )
SALES
2500.0
1900.0
1200.0
NULL
3458.0
4519.0
RETURN VALUE:
10477.0

Conseil

Vous pouvez effectuer des opérations arithmétiques dans les valeurs transmises à SUM avant le calcul du total par la fonction. Par exemple :
SUM( QTY * PRICE - DISCOUNT )