

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função NULLIF no Amazon QLDB
NULLIF

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, dadas as duas expressões, use a função `NULLIF` para retornar `NULL` se as duas forem avaliadas para o mesmo valor. Caso contrário, essa função retornará o resultado da avaliação da primeira expressão.

A função `NULLIF` não propaga `NULL` e `MISSING`.

## Sintaxe


```
NULLIF ( expression1, expression2 )
```

## Argumentos


*expression1*, *expression2*  
O dois nomes do campo ou a expressão do tipo de dados que a função compara. Esses parâmetros podem ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

## Tipo de retorno


Qualquer tipo de dados com suporte. O tipo de retorno é `NULL` ou igual ao tipo da primeira expressão.

## Exemplos


```
NULLIF(1, 1)             -- null
NULLIF(1, 2)             -- 1
NULLIF(1.0, 1)           -- null
NULLIF(1, '1')           -- 1
NULLIF([1], [1])         -- null
NULLIF(1, NULL)          -- 1
NULLIF(NULL, 1)          -- null
NULLIF(null, null)       -- null
NULLIF(missing, null)    -- null
NULLIF(missing, missing) -- null

-- Runnable statements
SELECT NULLIF(1, 1) FROM << 0 >>   -- null
SELECT NULLIF(1, '1') FROM << 0 >> -- 1
```

## Funções relacionadas

+ [AGLUTINAR](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)