- Catégories :
Fonctions d’agrégation (Général) , Fonctions de la fenêtre (Général, Cadre de fenêtre)
SUM¶
Renvoie la somme des enregistrements non NULL pour expr. Vous pouvez utiliser le mot clé DISTINCT pour calculer la somme de valeurs uniques non nulles. Si tous les enregistrements d’un groupe sont NULL, la fonction renvoie NULL.
Syntaxe¶
Fonction d’agrégation
SUM( [ DISTINCT ] <expr1> )
Fonction de fenêtre
SUM( <expr1> ) OVER ( [ PARTITION BY <expr2> ] [ ORDER BY <expr3> [ ASC | DESC ] [ <window_frame> ] ] )
Pour plus d’informations sur la syntaxe cadre_fenêtre , voir Syntaxe et utilisation du cadre de fenêtre .
Arguments¶
expr1L’expression est une expression qui correspond à un type de données numérique (INTEGER, FLOAT, DECIMAL, etc.).
expr2C’est l’expression facultative à partir de laquelle effectuer la partition.
expr3C’est l’expression facultative à partir de laquelle effectuer le classement dans chaque partition. (Cela ne contrôle pas l’ordre de la sortie de la requête entière.)
Notes sur l’utilisation¶
Les valeurs numériques sont additionnées dans un type de données équivalent ou supérieur.
SUM sur une colonne de chaîne entraîne une conversion implicite de l’entrée en valeurs à virgule flottante. Si une conversion ne peut pas se produire, une erreur est générée.
Lorsque cette fonction est appelée en tant que fonction de fenêtre :
Le mot clé DISTINCT est autorisé syntaxiquement, mais est ignoré.
Si une sous-clause ORDER BY est utilisée à l’intérieur de la clause OVER, un cadre de fenêtre doit être utilisé. Si aucun cadre de fenêtre n’est spécifié, la valeur par défaut est un cadre de fenêtre cumulatif :
RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROWPour plus d’informations sur les cadres de fenêtre, y compris la syntaxe et des exemples, voir Syntaxe et utilisation du cadre de fenêtre.
Pour plus d’informations sur les cadres de fenêtre implicites, voir Notes sur l’utilisation du cadre de fenêtre.
Exemples¶
CREATE OR REPLACE TABLE sum_example(k INT, d DECIMAL(10,5),
s1 VARCHAR(10), s2 VARCHAR(10));
INSERT INTO sum_example VALUES
(1, 1.1, '1.1','one'), (1, 10, '10','ten'),
(2, 2.2, '2.2','two'), (2, null, null,'null'),
(3, null, null, 'null'),
(null, 9, '9.9','nine');
SELECT * FROM sum_example;
+------+----------+------+------+
| K | D | S1 | S2 |
|------+----------+------+------|
| 1 | 1.10000 | 1.1 | one |
| 1 | 10.00000 | 10.0 | ten |
| 2 | 2.20000 | 2.2 | two |
| 2 | NULL | NULL | null |
| 3 | NULL | NULL | null |
| NULL | 9.00000 | 9.9 | nine |
+------+----------+------+------+
SELECT SUM(d), SUM(s1) FROM sum_example;
+----------+---------+
| SUM(D) | SUM(S1) |
|----------+---------|
| 22.30000 | 23.2 |
+----------+---------+
select k, SUM(d), SUM(s1) FROM sum_example GROUP BY k;
+------+----------+---------+
| K | SUM(D) | SUM(S1) |
|------+----------+---------|
| 1 | 11.10000 | 11.1 |
| 2 | 2.20000 | 2.2 |
| 3 | NULL | NULL |
| NULL | 9.00000 | 9.9 |
+------+----------+---------+
SELECT SUM(s2) FROM sum_example;
100038 (22018): Numeric value 'one' is not recognized
Le script ci-dessous montre l’utilisation de cette fonction (et d’autres fonctions de la fenêtre) dans un contexte de fenêtrage :
CREATE OR REPLACE TABLE example_cumulative (p INT, o INT, i INT); INSERT INTO example_cumulative VALUES ( 0, 1, 10), (0, 2, 20), (0, 3, 30), (100, 1, 10),(100, 2, 30),(100, 2, 5),(100, 3, 11),(100, 3, 120), (200, 1, 10000),(200, 1, 200),(200, 1, 808080),(200, 2, 33333),(200, 3, null), (200, 3, 4), (300, 1, null), (300, 1, null);SELECT p, o, i, COUNT(i) OVER (PARTITION BY p ORDER BY o ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) count_i_Rows_Pre, SUM(i) OVER (PARTITION BY p ORDER BY o ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) sum_i_Rows_Pre, AVG(i) OVER (PARTITION BY p ORDER BY o ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) avg_i_Rows_Pre, MIN(i) OVER (PARTITION BY p ORDER BY o ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) min_i_Rows_Pre, MAX(i) OVER (PARTITION BY p ORDER BY o ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) max_i_Rows_Pre FROM example_cumulative ORDER BY p,o; +-----+---+--------+------------------+----------------+----------------+----------------+----------------+ | P | O | I | COUNT_I_ROWS_PRE | SUM_I_ROWS_PRE | AVG_I_ROWS_PRE | MIN_I_ROWS_PRE | MAX_I_ROWS_PRE | |-----+---+--------+------------------+----------------+----------------+----------------+----------------| | 0 | 1 | 10 | 1 | 10 | 10.000 | 10 | 10 | | 0 | 2 | 20 | 2 | 30 | 15.000 | 10 | 20 | | 0 | 3 | 30 | 3 | 60 | 20.000 | 10 | 30 | | 100 | 1 | 10 | 1 | 10 | 10.000 | 10 | 10 | | 100 | 2 | 30 | 2 | 40 | 20.000 | 10 | 30 | | 100 | 2 | 5 | 3 | 45 | 15.000 | 5 | 30 | | 100 | 3 | 11 | 4 | 56 | 14.000 | 5 | 30 | | 100 | 3 | 120 | 5 | 176 | 35.200 | 5 | 120 | | 200 | 1 | 10000 | 1 | 10000 | 10000.000 | 10000 | 10000 | | 200 | 1 | 200 | 2 | 10200 | 5100.000 | 200 | 10000 | | 200 | 1 | 808080 | 3 | 818280 | 272760.000 | 200 | 808080 | | 200 | 2 | 33333 | 4 | 851613 | 212903.250 | 200 | 808080 | | 200 | 3 | NULL | 4 | 851613 | 212903.250 | 200 | 808080 | | 200 | 3 | 4 | 5 | 851617 | 170323.400 | 4 | 808080 | | 300 | 1 | NULL | 0 | NULL | NULL | NULL | NULL | | 300 | 1 | NULL | 0 | NULL | NULL | NULL | NULL | +-----+---+--------+------------------+----------------+----------------+----------------+----------------+