تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
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