coalesce دالة

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime

إرجاع الوسيطة الأولى غير الخالية.

بناء الجملة

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