更新时间:2026-11-06 GMT+08:00
分享

条件函数

概述

条件函数根据条件表达式返回不同的值。CASE WHEN支持多条件分支逻辑,IF实现简单的条件取值,COALESCE用于空值替换,NULLIF用于等值置空,ISNULL/ISNOTNULL用于空值判断,GREATEST/LEAST用于多值极值选取。AI DataLake支持完整的条件函数能力。

更多内容请参考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

相关文档