1º valor preenchido da lista.
| Campo | Valor |
|---|---|
| Categoria | Lógica |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 2 ou mais argumentos |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: COALESCE. Aliases aceitos (maiúsc./minúsc. indiferente): primeiro.
Assinatura#
código
COALESCE(expr; arg2; …)Todos os argumentos são expressões.
Retorno#
O 1º valor preenchido da lista (mantém o tipo).
Tratamento de nulos#
Pula os vazios e devolve o 1º preenchido; tudo vazio devolve vazio.
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: COALESCE
- Compatibilidade: Compatível com DAX
- Observação: Primeiro valor preenchido da lista.
Exemplos#
código
COALESCE(desconto; 0)Exemplo com valores#
Entrada: 1 / 0 (vazio) e alternativa 99.
código
COALESCE(1 / 0; 99) → 99Resultado esperado: 99
Exemplo de negócio#
Preencher um desconto ausente com 0 no lugar de deixar vazio.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.