Concatenate

Neste artigo:

1. Sobre a função
2. Sintaxe
3. Exemplo: concatenação de literais
4. Exemplo: concatenação de cadeias de caracteres em colunas
5. Exemplo: concatenação condicional de cadeias de caracteres em colunas
6. Documentação

Sobre a função:

• A função CONCATENATE une duas cadeias de caracteres de texto em uma cadeia de caracteres de texto. Os itens unidos podem ser texto, números, valores boolianos representados como texto ou uma combinação desses itens. Você também poderá usar uma referência de coluna se a coluna contiver valores apropriados.

• A função CONCATENATE no DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se você precisar concatenar várias colunas, crie uma série de cálculos ou use o operador de concatenação (&) para unir todas elas em uma expressão mais simples.

• Se você quiser usar cadeias de caracteres de texto diretamente, em vez de usar uma referência de coluna, deverá colocar cada cadeia de caracteres entre aspas duplas.

• Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Sintaxe

CONCATENATE(<text1>, <text2>)  

text1A: primeira cadeia de caracteres de texto a ser unida em uma única cadeia de caracteres de texto. A cadeia de caracteres pode incluir texto ou números. Você também pode usar referências de coluna.

text2A: segunda cadeia de caracteres de texto a ser unida em uma única cadeia de caracteres de texto. A cadeia de caracteres pode incluir texto ou números. Você também pode usar referências de coluna.

O valor retornado é uma cadeia de caracteres concatenada.

Exemplo 1: concatenação de literais

= CONCATENATE("Hello ", "World")

• A fórmula do exemplo cria um novo valor de cadeia de caracteres combinando dois valores de cadeia de caracteres que você fornece como argumentos.

Exemplo 2: concatenação de cadeias de caracteres em colunas

= CONCATENATE(Customer[LastName], CONCATENATE(", ", Customer[FirstName]))

• A fórmula do exemplo retorna o nome completo do cliente, conforme listado em um catálogo de telefones. Observe como uma função aninhada é usada como o segundo argumento. Essa é uma maneira de concatenar várias cadeias de caracteres quando você tem mais de dois valores que deseja usar como argumentos.

Exemplo 3: concatenação condicional de cadeias de caracteres em colunas

= CONCATENATE( [FirstName]&" ",
CONCATENATE( IF( LEN([MiddleName])>1, 
LEFT([MiddleName],1)&" ", ""), [LastName]))

• A fórmula de exemplo cria uma nova coluna calculada na tabela Customer com o nome completo do cliente como uma combinação de primeiro nome, primeira letra do segundo nome e sobrenome. Se não houver um segundo nome, o sobrenome virá diretamente após o primeiro nome. Se houver um segundo nome, somente a primeira letra do segundo nome será usada e será seguida por um ponto.

• Essa fórmula usa funções aninhadas CONCATENATE e IF, acompanhadas do operador de E comercial (&) para concatenar condicionalmente três valores de cadeia de caracteres e adicionar espaços como separadores.

Documentação

Este artigo foi desenvolvido com base na documentação oficial do Power Bi, para mais informações sobre a função CONCATENATE, consulte a documentação.