Junta textos.
| Campo | Valor |
|---|---|
| Categoria | Texto |
| 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: CONCATENAR. Aliases aceitos (maiúsc./minúsc. indiferente): concatenate, concat.
Assinatura#
código
CONCATENAR(expr; arg2; …)Todos os argumentos são expressões.
Retorno#
Texto.
Tratamento de nulos#
Argumento vazio entra como texto vazio (não quebra a junção).
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: CONCATENATE
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Junta N textos; o CONCATENATE do DAX aceita só 2 (ou use o operador &).
Exemplos#
código
CONCATENAR(uf; " - "; canal)Exemplo com valores#
Entrada: "SP", " - ", "loja".
código
CONCATENAR("SP"; " - "; "loja") → "SP - loja"Resultado esperado: "SP - loja"
Exemplo de negócio#
Montar um rótulo “UF - canal” para a legenda do gráfico.
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.