# 比较函数
#### 概述
比较函数用于对两个表达式进行比较运算，返回BOOLEAN类型结果。AI DataLake支持SQL标准中的等值比较、大小比较、范围比较、模式匹配和空值判断等完整的比较运算能力。
更多内容请参考[Comparison Functions](https://nightlies.apache.org/flink/flink-docs-release-1.20/docs/dev/table/functions/systemfunctions/#comparison-functions)。
#### 适用场景
- **WHERE过滤**：在查询中使用比较条件过滤数据行。
- **JOIN关联**：在JOIN条件中使用等值比较关联不同表。
- **条件分支**：在CASE WHEN中使用比较结果控制业务逻辑。
- **数据校验**：通过比较运算检测数据的有效性和一致性。
 
#### 约束与限制
- 比较运算的两端数据类型必须兼容，否则需显式CAST转换。
- NULL与任何值比较结果均为NULL（不是TRUE也不是FALSE），需使用IS NULL判断。
- BETWEEN 是闭区间，包含两端边界值，即value1 BETWEEN value2 AND value3等价于value1 \>= value2 AND value1 \<= value3。
- LIKE中%匹配任意字符序列（包括空序列），_匹配恰好一个字符；如需匹配通配符本身，需使用ESCAPE子句转义。 若IN列表中包含NULL，且value1不在列表的非NULL值中，则结果为NULL而非FALSE。
  
 
#### 语法结构
| 语法                                    | 返回类型     | 说明                                                                                                                                                                                                    | 示例                  |
|:---|:---|:---|:---|
| value1 = value2                        | BOOLEAN   | 等值比较。 若value1等于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容；若任一操作数为NULL则返回NULL。                                                                                    | ``` SELECT 1 = 1; -- TRUE ```                          |
| value1 \<\> value2                    | BOOLEAN  | 不等比较。 若value1不等于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容；若任一操作数为NULL则返回NULL。                                                                                   | ``` SELECT 1 <> 2; -- TRUE ```                         |
| value1 != value2                      | BOOLEAN   | 不等比较。 与 \<\> 语义完全等价，若value1不等于value2则返回TRUE；若任一操作数为NULL则返回NULL。                                                                                                 | ``` SELECT 1 != 2; -- TRUE ```                         |
| value1 \> value2                       | BOOLEAN | 大于比较。 若value1大于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容且可排序；若任一操作数为NULL则返回NULL。                                                                              | ``` SELECT 3 > 2; -- TRUE ```                          |
| value1 \>= value2                      | BOOLEAN | 大于等于比较。 若value1大于或等于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容且可排序；若任一操作数为NULL则返回NULL。                                                                        | ``` SELECT 2 >= 2; -- TRUE ```                         |
| value1 \< value2                        | BOOLEAN   | 小于比较。 若value1小于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容且可排序；若任一操作数为NULL则返回NULL。                                                                               | ``` SELECT 1 < 2; -- TRUE ```                          |
| value1 \<= value2                      | BOOLEAN  | 小于等于比较。 若value1小于或等于value2则返回TRUE，否则返回FALSE；value1和value2类型必须兼容且可排序；若任一操作数为 NULL则返回NULL。                                                                        | ``` SELECT 2 <= 3; -- TRUE ```                         |
| value IS NULL                         | BOOLEAN | 空值判断。 若value为NULL则返回TRUE，否则返回FALSE；不受NULL 参与常规比较返回NULL的规则影响，是判断NULL值的标准方式。                                                                                       | ``` SELECT NULL IS NULL; -- TRUE ```                   |
| value IS NOT NULL                     | BOOLEAN | 非空判断。 若value不为NULL则返回TRUE，否则返回FALSE；是IS NULL的逻辑取反。                                                                                                                 | ``` SELECT 1 IS NOT NULL; -- TRUE ```                  |
| value1 BETWEEN value2 AND value3      | BOOLEAN | 范围判断（闭区间）。 若value1在\[value2, value3\] 闭区间内则返回TRUE，即等价于value1 \>= value2 AND value1 \<= value3，包含两端边界值；value2应不大于value3，否则结果恒为FALSE；若任一操作数为NULL则返回NULL。           | ``` SELECT 2 BETWEEN 1 AND 3; -- TRUE ```              |
| value1 NOT BETWEEN value2 AND value3 | BOOLEAN | 不在范围内判断。 若value1不在\[value2, value3\]闭区间内则返回TRUE，等价于value1 \< value2 OR value1 \> value3；是BETWEEN的逻辑取反；若任一操作数为NULL则返回NULL。                                       | ``` SELECT 5 NOT BETWEEN 1 AND 3; -- TRUE ```          |
| value1 LIKE value2                   | BOOLEAN    | 模式匹配。 若value1匹配模式value2则返回TRUE；value1为被匹配字符串，value2为模式字符串；%匹配任意字符序列（包括空序列），*_匹配恰好一个字符；如需匹配%或*本身，需使用 ESCAPE子句定义转义字符；若任一操作数为NULL则返回NULL。                            | ``` SELECT 'hello' LIKE 'h%'; -- TRUE ```              |
| value1 NOT LIKE value2                | BOOLEAN  | 不匹配模式。 若value1不匹配模式value2则返回TRUE；通配符规则与 LIKE相同；是LIKE的逻辑取反；若任一操作数为NULL则返回 NULL。                                                                                   | ``` SELECT 'hello' NOT LIKE 'a%'; -- TRUE ```          |
| value1 IN (value2\[, value3\]\*)     | BOOLEAN  | 在值列表中判断。 若value1等于列表中任意一个值则返回TRUE；value1与列表中值类型必须兼容；若value1不在列表中且列表包含NULL，则返回NULL而非FALSE；若value1为NULL则返回NULL。                                                    | ``` SELECT 2 IN (1, 2, 3); -- TRUE ```                 |
| value1 NOT IN (value2\[, value3\]\*)  | BOOLEAN  | 不在值列表中判断。 若value1不等于列表中任何一个值则返回TRUE；是IN的逻辑取反；若列表包含NULL且value1不在列表的非NULL值中，则返回NULL而非TRUE；若value1为NULL则返回NULL。                                                      | ``` SELECT 5 NOT IN (1, 2, 3); -- TRUE ```             |
| value1 IS DISTINCT FROM value2       | BOOLEAN | 不同值判断（NULL安全）。 若value1和value2的值不同则返回TRUE；与\<\>的关键区别在于NULL处理：NULL IS DISTINCT FROM NULL返回 FALSE，NULL IS DISTINCT FROM非NULL返回TRUE，不会产生NULL结果；适用于需要将NULL视为可比较值的场景。 | ``` SELECT 1 IS DISTINCT FROM 2; -- TRUE ```           |
| value1 IS NOT DISTINCT FROM value2  | BOOLEAN | 相同值判断（NULL安全）。 若value1和value2的值相同则返回TRUE；与=的关键区别在于NULL处理：NULL IS NOT DISTINCT FROM NULL返回 TRUE，不会产生NULL结果；是IS DISTINCT FROM的逻辑取反；适用于需要将NULL视为相等值的场景。                 | ``` SELECT NULL IS NOT DISTINCT FROM NULL; -- TRUE ``` |
   
