Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:![]()
Coluna calculada
Tabela calculadaMedir
Cálculo visual
Retorna o valor ou avalia a expressão da matriz visual usando a navegação absoluta. Os filtros podem ser fornecidos para qualquer eixo na matriz visual. Todos os filtros omitidos são inferidos do contexto. Se nenhum valor único puder ser determinado, um erro será retornado.
Sintaxe
LOOKUP(<expression>, <colref>, <expression>[, <colref>, <expression>]...[, <AssociatedColumnsBehavior>])
Parâmetros
| Prazo | Definição |
|---|---|
expression |
A expressão a ser avaliada. |
colref |
(Opcional) A coluna a ser filtrada. |
expression |
(Opcional) O valor a ser filtrado. |
AssociatedColumnsBehavior |
(Opcional) Especifica como as colunas associadas são tratadas. Os valores permitidos são EXPLICIT (padrão) ou INFERRED. |
Valor de retorno
O valor da expressão depois que os filtros são aplicados.
Se não houver uma correspondência, um erro será retornado.
Se várias linhas corresponderem aos filtros, um erro será retornado.
Observações
O parâmetro AssociatedColumnsBehavior controla como o LOOKUP lida com colunas de eixo que são determinadas funcionalmente pelas coordenadas fornecidas:
EXPLICIT (padrão): quando o parâmetro é omitido ou definido como
EXPLICIT, LOOKUP usa apenas os filtros fornecidos explicitamente. As colunas de eixo não especificadas são inferidas do contexto atual. Esse é o comportamento de PESQUISA original.INFERIDO: Quando definido como
INFERRED, o mecanismo identifica quais colunas de eixo são determinadas funcionalmente pelas coordenadas fornecidas e as preenche automaticamente antes de avaliar a pesquisa. Por exemplo, se você filtrar por Ano, Trimestre e Mês, o mecanismo poderá inferir colunas relacionadas, como o dia ou a semana que correspondem a essas coordenadas.
Quando INFERRED é especificado e você fornece um valor para uma coluna que teria sido inferida, o valor fornecido é validado em relação ao valor inferido. Se eles entrarem em conflito, a chamada retornará BLANK, semelhante a como EXPLICIT retorna BLANK quando você fornece coordenadas conflitantes.
Exemplo 1
Neste exemplo, LOOKUP recupera a soma das vendas para a Categoria bicicletas. O primeiro argumento pode ser uma coluna ou uma expressão escalar.
Lookup Example 1 = LOOKUP(SUM([Sales Amount]), [Category], "Bikes")
Lookup Example 2 = LOOKUP([Sales Amount], [Category], "Bikes")
A captura de tela abaixo mostra a matriz com dois cálculos visuais.
Exemplo 2
Neste exemplo, o cálculo visual LookupExample2 recupera a soma das vendas do ano fiscal fy2018. Observe que o filtro de trimestre da linha será usado desde que não foi especificado explicitamente, resultando em nenhum resultado sendo retornado para FY2019 Q1 para FY2019 Q4 desde a combinação de FY2018 e FY2019 Q1 para FY2019 Q4 não existe. LookupExample3 especifica explicitamente o trimestre, portanto, não leva em conta o trimestre atual na linha.
LookupExample2 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018")
LookupExample3 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018", [Fiscal Quarter], "FY2018 Q1")
Exemplo 3
Este exemplo demonstra a diferença entre EXPLICIT e INFERRED o comportamento. Ambos os cálculos visuais pesquisam a soma das vendas de janeiro de 2025 especificando as coordenadas Ano, Trimestre e Nome do Mês.
Jan 2025 Sales (Explicit) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", EXPLICIT)
Jan 2025 Sales (Inferred) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", INFERRED)
Com EXPLICIT, a pesquisa retorna um valor somente na linha em que o contexto atual corresponde às coordenadas especificadas (a linha de janeiro de 2025). Em todas as outras linhas, a pesquisa retorna BLANK porque o contexto da linha atual está em conflito com os filtros especificados.
Com INFERREDo mecanismo identifica automaticamente as colunas associadas que são determinadas funcionalmente pelas coordenadas Ano, Trimestre e Nome do Mês. Como essas coordenadas identificam exclusivamente um ponto no tempo, a pesquisa retorna o valor em todas as linhas da matriz.