Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

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