Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

NULLIF

Aceita dois argumentos e retorna um valor NULL se eles forem iguais; caso contrário, retorna o primeiro argumento.

A função NULLIF equivale a CASE WHEN expression1 = expression2 THEN NULL ELSE expression1 END

NULLIF é útil com funções de agregação como AVG, MAX, MIN, SUM e COUNT, quando o conjunto de resultados contém valores especiais que não são NULL, mas que você quer tratar como NULL para fins de agregação.

Veja também:
[SELECT] [COALESCE] [IFNULL]


Sintaxe​

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

Argumentos​

expression
Duas expressões de qualquer tipo de dados que resultam em um valor NULL ou não NULL.

A função NULLIF procura em seus argumentos, da esquerda para a direita, um argumento que defina uma função de ordenação e usa essa função de ordenação em todas as comparações de strings. Se nenhum dos argumentos definir uma função de ordenação, a ordenação BINARY é usada.

Valor(es) retornado(s)​

Retorna NULL se os dois argumentos expression resultarem no mesmo valor; caso contrário, retorna o primeiro valor.


Exemplos​

Contar linhas em que um campo não é igual a um determinado valor​

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 name != 'controller-0';
*/

Para obter mais informações, consulte https://www.sqlite.org/lang_corefunc.html#nullif