Share via


Função RELATEDTABLE (DAX)

Avalia uma expressão de tabela em um contexto modificado pelos filtros fornecidos.

Sintaxe

RELATEDTABLE(<expression>,<filter1>,<filter2>,…)

Parâmetros

Termo

Definição

expression

A expressão de tabela a ser avaliada

filter1,filter2,…

Uma expressão booliana ou uma expressão de tabela que define um filtro

A expressão usada como o primeiro parâmetro deve ser uma tabela ou uma expressão que retorna uma tabela.

Estas restrições se aplicam a expressões boolianas que são usadas como argumentos:

  • A expressão não pode referenciar uma medida.

  • A expressão não pode usar uma função CALCULATE aninhada.

  • A expressão não pode usar funções que examinem uma tabela ou retornem uma tabela, inclusive funções de agregação.

Entretanto, uma expressão booliana pode usar qualquer função que procure um único valor, ou que calcule um valor escalar.

Valor de retorno

Uma tabela de valores.

Comentários

A função RELATEDTETABLE altera o contexto no qual os dados são filtrados e avalia a expressão no novo contexto especificado. Para cada coluna usada em um argumento de filtro, será removido qualquer filtro existente nessa coluna, e o filtro usado no argumento de filtro será aplicado.

Essa função é um sinônimo para a função CALCULATETABLE.

Exemplo

O exemplo a seguir usa a função RELATEDTABLE para obter Vendas por Internet em 2002; esse valor será posteriormente usado para calcular uma taxa de vendas em comparação com as vendas em 2002.

A tabela a seguir mostra os resultados do uso do código mostrado aqui.

Rótulos de Linha

Internet SalesAmount_USD

RelatedTable 2002 Internet Sales

Internet Sales to 2002 ratio

2001

$2,627,031.40

$5,681,440.58

0.46

2002

$5,681,440.58

$5,681,440.58

1.00

2003

$8,705,066.67

$5,681,440.58

1.53

2004

$9,041,288.80

$5,681,440.58

1.59

Total Geral

$26,054,827.45

$5,681,440.58

4.59

= SUMX( RELATEDTABLE('InternetSales_USD', 'DateTime'[CalendarYear]=2002)
     , [SalesAmount_USD])