CONCATENATE
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Une duas cadeias de texto em uma.
Sintaxe
CONCATENATE(<text1>, <text2>)
Parâmetros
| Termo | Definição |
|---|---|
| text1 | A 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. |
| text2 | A 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. |
Valor retornado
Uma cadeia de caracteres concatenada.
Comentários
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.
Exemplo: concatenação de literais
A fórmula de exemplo cria um novo valor de cadeia de caracteres combinando dois valores de cadeia de caracteres que você fornece como argumentos.
= CONCATENATE("Hello ", "World")
Exemplo: concatenação de cadeias de caracteres em colunas
A fórmula de 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.
= CONCATENATE(Customer[LastName], CONCATENATE(", ", Customer[FirstName]))
Exemplo: concatenação condicional de cadeias de caracteres em colunas
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.
= CONCATENATE( [FirstName]&" ", CONCATENATE( IF( LEN([MiddleName])>1, LEFT([MiddleName],1)&" ", ""), [LastName]))
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.
Exemplo: concatenação de colunas com tipos de dados diferentes
O exemplo a seguir demonstra como concatenar valores em colunas que têm tipos de dados diferentes. Se o valor que você está concatenando for numérico, ele será convertido implicitamente em texto. Se ambos os valores forem numéricos, eles serão convertidos em texto e concatenados como se fossem cadeias de caracteres.
| Descrição do produto | Abreviação do produto (coluna 1 da chave composta) | Número do produto (coluna 2 da chave composta) | Nova coluna de chave gerada |
|---|---|---|---|
| Mountain bike | MTN | 40 | MTN40 |
| Mountain bike | MTN | 42 | MTN42 |
= CONCATENATE('Products'[Product abbreviation],'Products'[Product number])
A função CONCATENATE no DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se você precisar adicionar mais argumentos, use o operador de E comercial (&). Por exemplo, a fórmula a seguir produz os resultados, MTN-40 e MTN-42.
= [Product abbreviation] & "-" & [Product number]