# 分组函数
#### 概述
分组函数用于GROUP BY扩展（如ROLLUP、CUBE、GROUPING SETS）中标识分组级别。AI DataLake支持SQL标准中的GROUP_ID和GROUPING/GROUPING_ID函数，用于区分不同分组组合并判断列是否参与当前分组聚合。
更多内容请参考[Grouping Functions](https://nightlies.apache.org/flink/flink-docs-release-1.20/docs/dev/table/functions/systemfunctions/#grouping-functions)。
#### 适用场景
- **多级聚合报表**：在ROLLUP、CUBE、GROUPING SETS等多级分组聚合中标识不同的分组组合。
- **小计与合计区分**：通过GROUPING函数判断某列是否在当前分组中被聚合（返回NULL），从而区分原始数据行和聚合行。
- **条件过滤**：在HAVING子句中使用GROUPING结果过滤特定分组级别。
 
#### 约束与限制
- GROUP_ID和GROUPING/GROUPING_ID函数仅在包含ROLLUP、CUBE或GROUPING SETS的GROUP BY语句中有意义。
- GROUPING_ID是GROUPING的别名，两者语义等价。
- GROUPING返回的位向量中，0表示对应列参与了GROUP BY，1表示对应列未参与（被聚合为NULL）。
 
#### 语法结构
| 语法                                                                                                                         | 返回类型     | 说明               | 示例                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| GROUP_ID()                                                                                                                 | INTEGER  | 返回唯一标识分组键组合的整数。 | ``` -- 配合ROLLUP使用，标识每个分组层级 SELECT dept, role, GROUP_ID() AS gid, COUNT(*) AS cnt FROM employees GROUP BY ROLLUP(dept, role); -- 结果示例： -- dept=Sales, role=Manager, gid=0, cnt=5 -- dept=Sales, role=NULL,   gid=0, cnt=10 -- dept=NULL,  role=NULL,   gid=0, cnt=50 ```                                                                                                                                                                                                                                                                                  |
| GROUPING(expression1 \[, expression2\]\* ) GROUPING_ID(expression1 \[, expression2\]\* ) | INTEGER | 返回给定分组表达式的位向量。  | ``` -- 配合ROLLUP使用，判断分组键是否被聚合 SELECT dept, role, GROUPING(dept, role) AS grp_bits, COUNT(*) AS cnt FROM employees GROUP BY ROLLUP(dept, role); -- 结果示例： -- dept=Sales, role=Manager, grp_bits=0, cnt=5 -- dept=Sales, role=NULL,   grp_bits=1, cnt=10 -- dept=NULL,  role=NULL,   grp_bits=3, cnt=50 -- 使用CASE WHEN区分聚合层级 SELECT CASE WHEN GROUPING(dept, role) = 0 THEN '明细' WHEN GROUPING(dept, role) = 1 THEN '部门小计' WHEN GROUPING(dept, role) = 3 THEN '总计' END AS level, dept, role, COUNT(*) AS cnt FROM employees GROUP BY ROLLUP(dept, role); ``` |
   
