適用於:Databricks SQL
Databricks Runtime
傳回第一個非 Null 引數。
語法
coalesce(expr1 [, ...] )
引數
退貨
結果類型是 參數的最小公用類型。
至少必須有一個參數。
與在調用函式之前會先評估所有參數的普通函式不同,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