Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Use NULLIF para substituir seletivamente um valor específico nos dados por NULL. Isso pode ser útil em situações em que um valor específico representa dados ausentes ou inválidos e você quer marcá-lo explicitamente como NULL para análise ou processamento posterior.
Exemplo de uso
Substitua -1 no campo Desconto por NULL.
NULLIF(Discount, -1)
Sintaxe
NULLIF( input_expression, expression_to_match )
Parâmetros
input_expression
A expressão a ser avaliada. Use qualquer expressão válida como input_expression.
expression_to_match
NULLIF compara expression_to_match com input_expression. Se os dois forem iguais, NULLIF vai retornar nulo. Caso contrário, retornará input_expression. Use qualquer expressão válida como expression_to_match.
Exemplo
Imagine que você queira calcular o desconto médio dado aos seus clientes. O aplicativo representa "sem desconto" como -1. A fórmula AVG(Discount) vai contar -1 e retornar um resultado incorreto. Para evitar isso, é possível converter os -1s em valores NULLS. Para fazer isso, crie um novo campo chamado, por exemplo, Desconto com nulo :
NULLIF(Discount, -1)
Essa fórmula pode ser lida como "Se o campo Desconto for -1, retorne nulo. Caso contrário, retorne Desconto".
Então, será possível calcular o desconto médio ignorando os pedidos sem desconto:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-31 UTC."],[],[],null,["# NULLIF\n\nUse `NULLIF` to selectively replace a specific value in your data with NULL. This can be helpful in situations where a particular value represents missing or invalid data, and you want to explicitly mark it as NULL for further analysis or processing.\n\nSample usage\n------------\n\nReplace -1 in the **Discount** field with NULL.\n\n`NULLIF(Discount, -1)`\n\nSyntax\n------\n\n`NULLIF( `\u003cvar translate=\"no\"\u003einput_expression\u003c/var\u003e`, `\u003cvar translate=\"no\"\u003eexpression_to_match\u003c/var\u003e` )`\n\n### Parameters\n\n#### input_expression\n\nThe expression to evaluate. You can use any valid expression as the \u003cvar translate=\"no\"\u003einput_expression\u003c/var\u003e.\n\n#### expression_to_match\n\n`NULLIF` compares \u003cvar translate=\"no\"\u003eexpression_to_match\u003c/var\u003e to \u003cvar translate=\"no\"\u003einput_expression\u003c/var\u003e. If the two are equal, `NULLIF` returns null, otherwise it returns the \u003cvar translate=\"no\"\u003einput_expression\u003c/var\u003e. You can use any valid expression as the \u003cvar translate=\"no\"\u003eexpression_to_match\u003c/var\u003e.\n\nExample\n-------\n\nSuppose you want to calculate the average discount given to your customers. Your application represents \"no discount\" as -1. The formula `AVG(Discount)` will count -1 and return an incorrect result. To avoid this, you can convert those -1s to NULLS. To do this, create a new field called, for example, **Discount With Nulls** :\n\n`NULLIF(`**`Discount`** `, -1)`\n\nThis formula can be read, \"If the **Discount** field is -1, return null, otherwise return **Discount**.\"\n\nYou can then calculate the average discount ignoring orders with no discount:\n\n`AVG(`**`Discount With Nulls`** `)`"]]