SUBSTITUTOCOMÍNDICE

Aplica-se a:Colunacalculada Tabelacalculada MedidaCálculo visual

Retorna uma tabela que representa uma semijunção esquerda das duas tabelas fornecidas como argumentos. A semijunção é realizada usando colunas comuns, determinadas por nomes de colunas comuns e tipo de dados comum. As colunas que estão sendo unidas 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 na tabela de junção direita dada uma ordem de classificação especificada.

As colunas na tabela direita/segunda fornecida 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 se juntar.

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

Sintaxe

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

Parâmetros

Termo	Definição
tabela	Uma tabela a ser filtrada executando uma semijunção esquerda com a tabela especificada como o terceiro argumento (indexColumnsTable). Esta é a tabela no lado esquerdo da semijunção esquerda, portanto, a tabela retornada inclui as mesmas colunas que esta 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 a semijunção esquerda. Esta é a tabela do lado direito da semijunção esquerda. Somente os valores presentes nesta tabela serão retornados pela função. Além disso, as colunas desta tabela (com base nos nomes das colunas) serão substituídas por uma única coluna de índice na tabela retornada por esta 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 da tabela e esse índice é usado na tabela retornada para representar combinações de valores na indexColumnsTable conforme aparecem na tabela fornecida como o primeiro argumento para essa função.
ordem	(Opcional) Um valor que especifica como classificar orderBy_expression valores, ascendentes ou descendentes: Valor: Desc. Valor alternativo: 0(zero)/FALSE. Classifica em ordem decrescente de valores de orderBy_expression. Este é o valor padrão quando o parâmetro order é omitido. Valor: ASC. Valor alternativo: 1/TRUE. Classifica-se por ordem crescente de orderBy_expression.

Valor devolvido

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.

Observações

• Esta função não garante qualquer ordem de classificação de resultados.

• 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).