

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 AGLUTINAR no Amazon QLDB
<a name="ql-functions.coalesce"></a>

**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, com uma lista de um ou mais argumentos, use `COALESCE` a função para avaliar os argumentos na ordem da esquerda para a direita e retornar o primeiro valor que não seja de um tipo desconhecido (`NULL` ou `MISSING`). Se todos os tipos de argumentos forem desconhecidos, o resultado será `NULL`.

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

## Sintaxe
<a name="ql-functions.coalesce.syntax"></a>

```
COALESCE ( expression [, expression, ... ] )
```

## Argumentos
<a name="ql-functions.coalesce.arguments"></a>

*expression*  
A lista de um ou mais nomes de campo ou expressões que a função avalia. Cada argumento pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

## Tipo de retorno
<a name="ql-functions.coalesce.return-type"></a>

Qualquer tipo de dados com suporte. O tipo de retorno é `NULL` ou igual ao tipo da primeira expressão que é avaliada como um valor não nulo e não ausente.

## Exemplos
<a name="ql-functions.coalesce.examples"></a>

```
SELECT COALESCE(1, null) FROM << 0 >>         -- 1
SELECT COALESCE(null, null, 1) FROM << 0 >>   -- 1
SELECT COALESCE(null, 'string') FROM << 0 >>  -- "string"
```

## Funções relacionadas
<a name="ql-functions.coalesce.related"></a>
+ [EXISTS](ql-functions.exists.md)
+ [NULLIF](ql-functions.nullif.md)