# 条件函数
#### 概述
条件函数根据条件表达式返回不同的值。CASE WHEN支持多条件分支逻辑，IF实现简单的条件取值，COALESCE用于空值替换，NULLIF用于等值置空，ISNULL/ISNOTNULL用于空值判断，GREATEST/LEAST用于多值极值选取。AI DataLake支持完整的条件函数能力。
更多内容请参考[Conditional Functions](https://nightlies.apache.org/flink/flink-docs-release-1.20/docs/dev/table/functions/systemfunctions/#conditional-functions)。
#### 适用场景
- **数据分类**：通过CASE WHEN将连续值映射为离散分类，如将金额划分为高/中/低档位。
- **条件取值**：通过IF函数快速在两个值之间选择，如根据标志位返回不同状态文本。
- **空值替换**：通过COALESCE将NULL替换为默认值，避免NULL参与运算导致结果为NULL。
- **等值置空**：通过NULLIF在两个值相等时返回NULL，典型用法是避免除零错误。
- **空值判断**：通过ISNULL/ISNOTNULL在WHERE条件或CASE WHEN中判断值是否为NULL。
- **极值选取**：通过GREATEST/LEAST在多个列或表达式中选取最大或最小值，自动跳过NULL。
 
#### 约束与限制
- 所有WHEN/THEN和ELSE的返回值类型必须兼容，系统会自动推导公共类型；若缺少ELSE子句且无条件满足，则返回NULL。
- true_value与false_value的类型必须兼容，系统会自动推导公共类型；condition必须为BOOLEAN类型。
- 要求至少两个参数；所有参数类型必须兼容，返回类型为所有参数的公共类型。
- value1和value2类型必须可比较；仅在value1 = value2为TRUE时返回NULL，若比较结果为NULL则返回value1。
- 要求至少两个参数；所有参数类型必须兼容且可排序；NULL值会被自动跳过，若所有值均为NULL则返回NULL。
 
#### 语法结构
| 语法                                                                                      | 返回类型                           | 说明                                                                                                                                                       | 示例                                               |
|:---|:---|:---|:---|
| CASE WHEN condition1 THEN result1 \[WHEN condition2 THEN result2\]\* \[ELSE result\] END | 与result一致                     | 搜索型条件分支。按条件顺序依次求值，返回第一个满足条件（condition 为 TRUE）的result；若所有条件均不满足且存在 ELSE子句则返回ELSE的值；若所有条件均不满足且无ELSE子句则返回NULL；condition必须为BOOLEAN类型；所有 result类型必须兼容。       | ``` SELECT CASE WHEN 1 > 2 THEN 'a' WHEN 2 > 1 THEN 'b' ELSE 'c' END; -- 'b' ```     |
| CASE value WHEN value1 THEN result1 \[WHEN value2 THEN result2\]\* \[ELSE result\] END    | 与result一致                      | 值匹配型条件分支。将value依次与每个WHEN后的valueN做等值比较，返回第一个匹配的result；若均不匹配且存在ELSE 子句则返回ELSE的值；若均不匹配且无ELSE子句则返回 NULL；value与各valueN类型必须可比较；所有result类型必须兼容。                  | ``` SELECT CASE 2 WHEN 1 THEN 'one' WHEN 2 THEN 'two' ELSE 'other' END; -- 'two' ``` |
| IF(condition, true_value, false_value)                                                   | 与 true_value/false_value的公共类型一致 | 条件取值函数。若condition为TRUE则返回true_value，若 condition为FALSE则返回false_value；condition必须为 BOOLEAN类型；true_value与false_value类型必须兼容；若 condition为NULL则返回false_value。 | ``` SELECT IF(1 > 2, 'a', 'b'); -- 'b' ```                                           |
| COALESCE(value1, value2, ...)                                                            | 与第一个非 NULL值一致                | 返回参数列表中第一个非NULL的值；要求至少两个参数；所有参数类型必须兼容；若所有参数均为NULL则返回NULL。                                                                                                | ``` SELECT COALESCE(NULL, NULL, 'default'); -- 'default' ```                         |
| NULLIF(value1, value2)                                                                    | 与value1一致或 NULL                | 等值置空函数。若value1等于value2则返回NULL，否则返回 value1；value1和value2 类型必须可比较；常用于避免除零错误（如 amount / NULLIF(count, 0)）。                                                   | ``` SELECT NULLIF(5, 5); -- NULL ```                                                 |
| ISNULL(value)                                                                             | BOOLEAN                        | 空值判断函数。若value为NULL则返回TRUE，否则返回 FALSE；等价于value IS NULL；不受NULL参与常规比较返回NULL的规则影响。                                                                          | ``` SELECT ISNULL(NULL); -- TRUE ```                                                 |
| ISNOTNULL(value)                                                                           | BOOLEAN                          | 非空判断函数。若value不为NULL 则返回TRUE，否则返回FALSE；等价于value IS NOT NULL；是ISNULL的逻辑取反。                                                                                 | ``` SELECT ISNOTNULL(1); -- TRUE ```                                                 |
| GREATEST(value1, value2, ...)                                                             | 与参数公共类型一致                       | 返回参数列表中的最大值，自动跳过NULL；要求至少两个参数；所有参数类型必须兼容且可排序；若所有值均为NULL则返回 NULL。                                                                                        | ``` SELECT GREATEST(3, 1, 4, 1, 5); -- 5 ```                                         |
| LEAST(value1, value2, ...)                                                                 | 与参数公共类型一致                      | 返回参数列表中的最小值，自动跳过NULL；要求至少两个参数；所有参数类型必须兼容且可排序；若所有值均为NULL则返回NULL。                                                                                            | ``` SELECT LEAST(3, 1, 4, 1, 5); -- 1 ```                                            |
   
