适用于:
Databricks SQL
Databricks Runtime
返回第一个非 NULL 参数。
语法
coalesce(expr1 [, ...] )
参数
-
exprN:所有共享最小公有类型的exprN表达式。
返回
结果类型是参数的最不常见类型。
至少必须有一个参数。
与在调用函数之前计算所有参数的正则函数不同,在找到非 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