Ler em inglês

Partilhar via


CONCATENAR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Junta duas cadeias de texto em uma cadeia de texto.

Sintaxe

DAX
CONCATENATE(<text1>, <text2>)  

Parâmetros

Vigência Definição
text1 A primeira cadeia de caracteres de texto a ser unida em uma única cadeia 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 texto. A cadeia de caracteres pode incluir texto ou números. Você também pode usar referências de coluna.

Valor de retorno

Uma cadeia de caracteres concatenada.

Comentários

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

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

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

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

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.

DAX
= 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 telefônico. 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.

DAX
= 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 Cliente com o nome completo do cliente como uma combinação de nome, inicial do meio e sobrenome. Se não houver um nome do meio, o sobrenome vem logo após o primeiro nome. Se houver um nome do meio, apenas a primeira letra do nome do meio é usada e a letra inicial é seguida por um ponto.

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

Esta fórmula usa as funções aninhadas CONCATENATE e IF, juntamente com o operador E comercial (&), para concatenar condicionalmente três valores de cadeia de caracteres e adicionar espaços como separadores.

Exemplo: concatenação de colunas com diferentes tipos de dados

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, o valor será implicitamente convertido em texto. Se ambos os valores forem numéricos, ambos os valores serão convertidos em texto e concatenados como se fossem cadeias de caracteres.

Descrição do produto Abreviatura do produto (coluna 1 da chave composta) Número do produto (coluna 2 da chave composta) Nova coluna de chave gerada
Bicicleta de montanha MTN 40 MTN40
Bicicleta de montanha MTN 42 MTN42
DAX
= CONCATENATE('Products'[Product abbreviation],'Products'[Product number])  

A função CONCATENAR no DAX aceita apenas dois argumentos, enquanto a função CONCATENAR do Excel aceita até 255 argumentos. Se precisar adicionar mais argumentos, você pode usar o operador E comercial (&). Por exemplo, a fórmula a seguir produz os resultados, MTN-40 e MTN-42.

DAX
= [Product abbreviation] & "-" & [Product number]  

CONCATENATEX