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
NULLIFequivale aCASE WHEN expression1 = expression2 THEN NULL ELSE expression1 END
NULLIFé útil com funções de agregação comoAVG,MAX,MIN,SUMeCOUNT, quando o conjunto de resultados contém valores especiais que não sãoNULL, mas que você quer tratar comoNULLpara 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
NULLIFprocura 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çãoBINARYé 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