coalesce 函数

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime

返回第一个非 NULL 参数。

语法

coalesce(expr1 [, ...] )

参数

返回

结果类型是参数的最不常见类型

至少必须有一个参数。 与在调用函数之前计算所有参数的正则函数不同,在找到非 null 值之前, coalesce 计算从左到右的参数。 如果所有参数均为 NULL,则结果为 NULL

特殊注意事项适用于 VARIANT 类型。 有关详细信息,请参阅 isnull 函数

示例

> SELECT coalesce(NULL, 1, NULL);
 1

-- The following example raises a runtime error because the second argument is evaluated.
>  SELECT coalesce(NULL, 5 / 0);
 Error: DIVISION_BY_ZERO

-- The following example raises no runtime error because the second argument is not evaluated.
> SELECT coalesce(2, 5 / 0);
 2

> SELECT coalesce(NULL, 'hello');
 hello