Ler em inglês

Compartilhar via


LOOKUPVALUE

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna o valor da linha que atende a todos os critérios especificados por uma ou mais condições de pesquisa.

Sintaxe

DAX
LOOKUPVALUE (
    <result_columnName>,
    <search_columnName>,
    <search_value>
    [, <search2_columnName>, <search2_value>]…
    [, <alternateResult>]
)

Parâmetros

Prazo Definição
result_columnName O nome de uma coluna existente que contém o valor que você deseja retornar. Não pode ser uma expressão.
search_columnName O nome de uma coluna existente. Ele pode estar na mesma tabela que result_columnName ou em uma tabela relacionada. Não pode ser uma expressão. Vários pares de search_columnName e search_value podem ser especificados.
search_value O valor a ser pesquisado em search_columnName. Vários pares de search_columnName e search_value podem ser especificados.
alternateResult (Opcional) O valor retornado quando o contexto para result_columnName foi filtrado para zero ou mais de um valor distinto. Se não for especificado, a função retornará BLANK quando result_columnName for filtrado para zero valores ou um erro quando houver mais de um valor distinto no contexto para result_columnName.

Valor de retorno

O valor de result_columnName na linha em que todos os pares de search_columnName e search_value têm uma correspondência exata.

Se não houver uma correspondência que satisfaça todos os valores de pesquisa, BLANK ou alternateResult (se especificado) serão retornados. Em outras palavras, a função não retornará um valor de pesquisa se apenas alguns dos critérios corresponderem.

Se várias linhas corresponderem aos valores de pesquisa e os valores no result_columnName dessas linhas forem idênticos, esse valor será retornado. No entanto, se result_columnName retornar valores diferentes, um erro ou alternateResult (se especificado) será retornado.

Observações

  • Se houver uma relação entre a tabela que contém a coluna de resultados e tabelas que contêm as colunas de pesquisa, na maioria dos casos, usar a função RELATED em vez de LOOKUPVALUE será mais eficiente e fornecerá melhor desempenho.

  • Vários pares de search_columnName e search_value podem ser especificados.

  • Os parâmetros search_value e alternateResult são avaliados antes que a função itera pelas linhas da tabela de pesquisa.

  • Evite usar funções ISERROR ou IFERROR para capturar um erro retornado por LOOKUPVALUE. Se algumas entradas na função resultarem em um erro quando um único valor de saída não puder ser determinado, fornecer um parâmetro alternateResult será a maneira mais confiável e de alto desempenho para lidar com o erro.

  • O parâmetro alternateResult retorna um erro se especificado em uma coluna calculada do Power Pivot.

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

Exemplo 1

Neste exemplo, LOOKUPVALUE é usado para pesquisar a Taxa Média da moeda usada para pagar o pedido no dia em que o pedido foi feito:

DAX
Exchange Rate = 
LOOKUPVALUE (
    'Currency Rate'[Average Rate],
    'Currency Rate'[CurrencyKey], [CurrencyKey],
    'Currency Rate'[DateKey], [OrderDateKey]
)

A Data do Pedido e a Moeda são necessárias para localizar a Taxa Média para a data e a moeda corretas. OrderDateKey e CurrencyKey são as chaves usadas para pesquisar a Taxa Média na tabela Taxa de Moeda.

Você pode usar a Taxa de Câmbio para calcular o Valor de Vendas em moeda local com:

DAX
Sales Amount Local Currency = [Sales Amount] * [Exchange Rate]

Exemplo 2

Neste exemplo, a seguinte coluna calculada definida na tabela Sales usa a função LOOKUPVALUE para retornar valores de canal da tabela Ordem de Vendas do .

DAX
CHANNEL = 
LOOKUPVALUE (
    'Sales Order'[Channel],
    'Sales Order'[SalesOrderLineKey],
    [SalesOrderLineKey]
)

No entanto, nesse caso, como há uma relação entre as tabelas Sales Order e Sales, é mais eficiente usar a função RELATED.

DAX
CHANNEL = RELATED('Sales Order'[Channel])

da função RELATED (DAX)
Funções de informações de