إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

NULLIF

تقبل وسيطتين وتعيد قيمة NULL إذا كانتا متساويتين، وإلا تعيد الوسيطة الأولى.

تكافئ الدالة NULLIF التعبير CASE WHEN expression1 = expression2 THEN NULL ELSE expression1 END

الدالة NULLIF مفيدة مع الدوال التجميعية مثل AVG وMAX وMIN وSUM وCOUNT، حين تحتوي مجموعة النتائج على قيم خاصة ليست NULL لكنك تريد معاملتها كقيمة NULL لأغراض التجميع.

راجع أيضًا:
[SELECT] [COALESCE] [IFNULL]


بناء الجملة​

SELECT NULLIF(expression1, expression2) FROM <multipartIdentifier>;

الوسيطات​

expression
تعبيران من أي نوع بيانات يُحلان إلى قيمة NULL أو قيمة غير NULL.

تبحث الدالة NULLIF في وسيطاتها من اليسار إلى اليمين عن وسيطة تحدد دالة ترتيب، وتستخدم دالة الترتيب هذه في جميع مقارنات السلاسل النصية. إذا لم تحدد أي من الوسيطتين دالة ترتيب، فإن الدالة تستخدم الترتيب BINARY.

القيمة المرجعة​

تعيد NULL إذا كانت الوسيطتان expression تُحلان إلى القيمة نفسها، وإلا تعيد القيمة الأولى.


أمثلة​

حساب عدد الصفوف التي لا يساوي فيها حقل قيمة معينة​

SELECT COUNT(NULLIF(name, 'controller-0'))
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/*
equivalent to:
SELECT COUNT(*) FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
AND name != 'controller-0';
*/

لمزيد من المعلومات، راجع https://www.sqlite.org/lang_corefunc.html#nullif