Filtro DAX - função USERELATIONSHIP
Descrição
Especifica o relacionamento a ser usado em um cálculo específico como aquele que existe entre columnName1 e columnName2.
Sintaxe
USERELATIONSHIP (<columnName1>, <columnName2>)
Parâmetros
Sr. Não. | Parâmetro e Descrição |
---|---|
1 | columnName1 Um nome totalmente qualificado de uma coluna que representa os muitos lados do relacionamento a ser usado. Se os parâmetros forem fornecidos em ordem reversa, a função os trocará antes de usá-los. Este parâmetro não pode ser uma expressão. |
2 | columnName2 Um nome totalmente qualificado de uma coluna que representa um lado ou lado de pesquisa do relacionamento a ser usado. Se os parâmetros forem fornecidos em ordem reversa, a função os trocará antes de usá-los. Este parâmetro não pode ser uma expressão. |
Valor de retorno
A função DAX USERELATIONSHIP não retorna nenhum valor. A função só habilita a relação indicada durante o cálculo.
Observações
USERELATIONSHIP só pode ser usado em funções DAX que têm um filtro como parâmetro. Por exemplo, funções CALCULATE, CALCULATETABLE, CLOSINGBALANCEMONTH, CLOSINGBALANCEQUARTER, CLOSINGBALANCEYEAR, OPENINGBALANCEMONTH, OPENINGBALANCEQUARTER, OPENINGBALANCEYEAR, TOTALMTD, TOTALQTD e TOTALYTD funções.
USERELATIONSHIP usa os relacionamentos existentes no modelo, identificando relacionamentos por suas colunas de ponto final.
Na USERELATIONSHIP, o status de um relacionamento não é importante; ou seja, se o relacionamento está ativo ou não, não afeta o uso da função. Mesmo se o relacionamento estiver inativo, ele será usado e substituirá quaisquer outros relacionamentos ativos que possam estar presentes no modelo, mas não mencionados nos parâmetros da função.
Um erro será retornado se alguma das colunas nomeadas como um parâmetro não fizer parte de um relacionamento ou se os parâmetros pertencerem a relacionamentos diferentes.
Se vários relacionamentos forem necessários para unir a tabela A à tabela B em um cálculo, cada relacionamento deve ser indicado em uma função USERELATIONSHIP diferente.
Se expressões CALCULATE estiverem aninhadas, e mais de uma expressão CALCULATE contiver uma função USERELATIONSHIP, então a USERELATIONSHIP mais interna é aquela que prevalece em caso de conflito ou ambigüidade.
Até 10 funções USERELATIONSHIP podem ser aninhadas. No entanto, sua expressão pode ter um nível mais profundo de aninhamento.
Exemplo
Product Sales:= CALCULATE (
SUM (Sales[Sales Amount]),
USERELATIONSHIP (Sales[Product],Products[Product])
)