Compartilhar via

RELATED

  • Artigo

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna um valor relacionado de outra tabela.

Sintaxe

RELATED(<column>)

Parâmetros

Termo Definição
column A coluna que contém os valores que você deseja recuperar.

Valor de retorno

Um único valor relacionado à linha atual.

Comentários

  • A função RELATED requer que exista uma relação entre a tabela atual e a tabela com informações relacionadas. Especifique a coluna que contém os dados desejados e a função segue uma relação muitos para um existente para buscar o valor da coluna especificada na tabela relacionada. Se uma relação não existir, você deverá criar uma relação.

  • Quando a função RELATED executa uma pesquisa, ela examina todos os valores na tabela especificada, independentemente de quaisquer filtros que possam ter sido aplicados.

  • A função RELATED precisa de um contexto de linha; portanto, ele só pode ser usado na expressão de coluna calculada, em que o contexto de linha atual é inequívoco ou como uma função aninhada em uma expressão que usa uma função de verificação de tabela. Uma função de verificação de tabela, como SUMX, obtém o valor do valor da linha atual e verifica outra tabela em busca de instâncias desse valor.

  • A função RELATED não pode ser usada para buscar uma coluna em uma relação limitada.

Exemplo

No exemplo a seguir, a medida Vendas na Internet que não são dos EUA é criada para produzir um relatório de vendas que exclui as vendas nos Estados Unidos. Para criar a medida, a tabela InternetSales_USD deve ser filtrada para excluir todas as vendas que pertencem aos Estados Unidos na tabela SalesTerritory. Os Estados Unidos, como país, aparecem cinco vezes na tabela SalesTerritory; uma vez para cada uma das seguintes regiões: Noroeste, Nordeste, Central, Sudoeste e Sudeste.

A primeira abordagem para filtrar as Vendas pela Internet, a fim de criar a medida, pode ser adicionar uma expressão de filtro como a seguinte:

FILTER('InternetSales_USD'
, 'InternetSales_USD'[SalesTerritoryKey]<>1 && 'InternetSales_USD'[SalesTerritoryKey]<>2 && 'InternetSales_USD'[SalesTerritoryKey]<>3 && 'InternetSales_USD'[SalesTerritoryKey]<>4 && 'InternetSales_USD'[SalesTerritoryKey]<>5)

No entanto, essa abordagem é contraintuitiva, propensa a erros de digitação e pode não funcionar se qualquer uma das regiões existentes for dividida no futuro.

Uma abordagem melhor seria usar a relação existente entre InternetSales_USD e SalesTerritory e afirmar explicitamente que o país deve ser diferente dos Estados Unidos. Para fazer isso, crie uma expressão de filtro como a seguinte:

FILTER( 'InternetSales_USD', RELATED('SalesTerritory'[SalesTerritoryCountry])<>"United States")

Essa expressão usa a função RELATED para pesquisar o valor do país na tabela SalesTerritory, começando com o valor da coluna chave, SalesTerritoryKey, na tabela InternetSales_USD. O resultado da pesquisa é usado pela função de filtro para determinar se a linha InternetSales_USD é filtrada ou não.

Observação

Se o exemplo não funcionar, talvez seja necessário criar uma relação entre as tabelas.

= SUMX(FILTER( 'InternetSales_USD'
            ,  RELATED('SalesTerritory'[SalesTerritoryCountry])
               <>"United States"
             )
     ,'InternetSales_USD'[SalesAmount_USD])

A tabela a seguir mostra apenas os totais de cada região, para provar que a expressão de filtro na medida, Vendas na Internet que não são dos EUA, funciona conforme o esperado.

Row Labels Internet Sales Non USA Internet Sales
Austrália US$ 4.999.021,84 US$ 4.999.021,84
Canadá US$ 1.343.109,10 US$ 1.343.109,10
França US$ 2.490.944,57 US$ 2.490.944,57
Alemanha US$ 2.775.195,60 US$ 2.775.195,60
Reino Unido US$ 5.057.076,55 US$ 5.057.076,55
Estados Unidos US$ 9.389.479,79
Grande Total US$ 26.054.827,45 US$ 16.665.347,67

O seguinte mostra o que você pode obter se tiver usado essa medida em um visual de tabela de relatório:

Row Labels Accessories Bikes Clothing Grand Total
2005 US$ 1.526.481,95 US$ 1.526.481,95
2006 US$ 3.554.744,04 US$ 3.554.744,04
2007 US$ 156.480,18 US$ 5.640.106,05 US$ 70.142,77 US$ 5.866.729,00
2008 US$ 228.159,45 US$ 5.386.558,19 US$ 102.675,04 US$ 5.717.392,68
Grande Total US$ 384.639,63 US$ 16.107.890,23 US$ 172.817,81 US$ 16.665.347,67

Conteúdo relacionado

Funções RELATEDTABLEFilter