SUBSTITUTEWITHINDEX

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna uma tabela que representa um semijoin esquerdo das duas tabelas fornecidas como argumentos. O semijoin é executado usando colunas comuns, determinadas por nomes de coluna comuns e tipo de dados comum. As colunas ingressadas são substituídas por uma única coluna na tabela retornada, que é do tipo inteiro e contém um índice. O índice é uma referência à tabela de junção à direita, dada uma ordem de classificação especificada.

As colunas na tabela direita/segundo fornecidas que não existem na tabela esquerda/primeira fornecida não são incluídas na tabela retornada e não são usadas para ingressar.

O índice começa em 0 (baseado em 0) e é incrementado por um para cada linha adicional na tabela de junção à direita/segundo fornecida. O índice é baseado na ordem de classificação especificada para a tabela de junção à direita/segundo.

Sintaxe

SUBSTITUTEWITHINDEX(<table>, <indexColumnName>, <indexColumnsTable>, [<orderBy_expression>, [<order>][, <orderBy_expression>, [<order>]]…])

Parâmetros

Termo	Definição
table	Uma tabela a ser filtrada executando um semijoin esquerdo com a tabela especificada como o terceiro argumento (indexColumnsTable). Esta é a tabela no lado esquerdo do semijoin esquerdo, portanto, a tabela retornada inclui as mesmas colunas dessa tabela, exceto que todas as colunas comuns das duas tabelas serão substituídas por uma única coluna de índice na tabela retornada.
indexColumnName	Uma cadeia de caracteres que especifica o nome da coluna de índice que está substituindo todas as colunas comuns nas duas tabelas fornecidas como argumentos para essa função.
indexColumnsTable	A segunda tabela para o semijoin esquerdo. Esta é a tabela no lado direito do semijoin esquerdo. Somente os valores presentes nesta tabela serão retornados pela função. Além disso, as colunas desta tabela (com base em nomes de coluna) serão substituídas por uma única coluna de índice na tabela retornada por essa função.
orderBy_expression	Qualquer expressão DAX em que o valor do resultado é usado para especificar a ordem de classificação desejada da tabela indexColumnsTable para gerar valores de índice corretos. A ordem de classificação especificada para a tabela indexColumnsTable define o índice de cada linha na tabela e esse índice é usado na tabela retornada para representar combinações de valores na indexColumnsTable conforme eles aparecem na tabela fornecida como o primeiro argumento para essa função.
order	(Opcional) Um valor que especifica como classificar orderBy_expression valores, crescentes ou decrescentes: Valor: Desc. Valor alternativo: 0(zero)/FALSE. Classifica em ordem decrescente de valores de orderBy_expression. Esse é o valor padrão quando o parâmetro order é omitido. Valor: ASC. Valor alternativo: 1/TRUE. Classifica em ordem crescente de orderBy_expression.

Valor de retorno

Uma tabela que inclui apenas os valores presentes na tabela indexColumnsTable e que tem uma coluna de índice em vez de todas as colunas presentes (por nome) na tabela indexColumnsTable.

Comentários

• Essa função não garante nenhuma ordem de classificação de resultado.

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