Catégories :: Fonctions d’agrégation (général)

GROUPING_ID¶

Décrit quelle expression parmi une liste d’expressions est regroupée dans une ligne produite par une requête GROUP BY.

Alias pour GROUPING.

Syntaxe¶

GROUPING_ID( <expr1> [ , <expr2> , ... ] )

Notes sur l’utilisation¶

GROUPING_ID n’est pas une fonction d’agrégat, mais plutôt une fonction d’utilité pouvant être utilisée avec l’agrégation pour déterminer le niveau d’agrégation pour lequel une ligne a été générée :

GROUPING_ID(expr) renvoie 0 pour une ligne groupée dans expr et 1 pour une ligne non groupée dans expr.
GROUPING_ID(expr1, expr2 , …, exprN) renvoie la représentation entière d’un vecteur bit contenant GROUPING_ID(expr1) , GROUPING_ID(expr2) , …, GROUPING_ID(exprN).

Exemples¶

Ces exemples utilisent le tableau et les données suivants :

CREATE OR REPLACE TABLE aggr2(col_x int, col_y int, col_z int);
INSERT INTO aggr2 VALUES (1, 2, 1), 
                         (1, 2, 3);
INSERT INTO aggr2 VALUES (2, 1, 10), 
                         (2, 2, 11), 
                         (2, 2, 3);

Cet exemple se regroupe sur col_x. L’appel de GROUPING_ID(col_x) renvoie 0, indiquant que col_x est effectivement l’une des colonnes de regroupement.

SELECT col_x, sum(col_z), GROUPING_ID(col_x)
    FROM aggr2 
    GROUP BY col_x
    ORDER BY col_x;
+-------+------------+--------------------+
| COL_X | SUM(COL_Z) | GROUPING_ID(COL_X) |
|-------+------------+--------------------|
|     1 |          4 |                  0 |
|     2 |         24 |                  0 |
+-------+------------+--------------------+

Cette requête regroupe des ensembles :

SELECT col_x, col_y, sum(col_z), 
       GROUPING_ID(col_x), 
       GROUPING_ID(col_y), 
       GROUPING_ID(col_x, col_y)
    FROM aggr2 
    GROUP BY GROUPING SETS ((col_x), (col_y), ())
    ORDER BY col_x ASC, col_y DESC;
+-------+-------+------------+--------------------+--------------------+---------------------------+
| COL_X | COL_Y | SUM(COL_Z) | GROUPING_ID(COL_X) | GROUPING_ID(COL_Y) | GROUPING_ID(COL_X, COL_Y) |
|-------+-------+------------+--------------------+--------------------+---------------------------|
|     1 |  NULL |          4 |                  0 |                  1 |                         1 |
|     2 |  NULL |         24 |                  0 |                  1 |                         1 |
|  NULL |  NULL |         28 |                  1 |                  1 |                         3 |
|  NULL |     2 |         18 |                  1 |                  0 |                         2 |
|  NULL |     1 |         10 |                  1 |                  0 |                         2 |
+-------+-------+------------+--------------------+--------------------+---------------------------+