Ler em inglês

Compartilhar via


COLAPSO

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Recupera um contexto em um nível mais alto em comparação com o contexto atual. Se uma expressão for fornecida, retornará seu valor no novo contexto, permitindo a navegação em hierarquias e cálculos em um nível mais alto.

Sintaxe

As sintaxes que executam a navegação e o cálculo.

DAX
COLLAPSE ( <expression>, <axis>[, N] )
COLLAPSE ( <expression>, <column>[, <column>] ... )

As sintaxes que executam somente navegação.

DAX
COLLAPSE ( <axis>[, N] )
COLLAPSE ( <column>[, <column>] ... )

Parâmetros

Prazo Definição
expression A expressão a ser avaliada no novo contexto.
axis Uma referência de eixo.
column Uma coluna na grade de dados.
N (Opcional) O número de níveis a serem recolhidos. Se omitido, o valor padrão será 1.

Valor de retorno

Para versões que executam navegação e cálculo, a função retorna o valor da expressão no novo contexto depois de navegar para um novo nível. Para versões que executam somente navegação, a função modifica o contexto de avaliação navegando para um novo nível.

Observações

  • Essa função só pode ser usada em cálculos visuais.
  • As versões somente de navegação da função podem ser usadas dentro da função CALCULATE.
  • Os níveis da hierarquia são determinados por todas as colunas em cada eixo referenciado pela referência do eixo.
  • Quando as colunas são especificadas, os eixos são determinados incluindo o eixo de cada coluna na primeira vez em que são encontrados.
  • Quando N é especificado, a função navega até os níveis N da hierarquia a partir do nível atual ou do nível mais alto, o que ocorrer primeiro.
  • Quando várias colunas são especificadas, a função navega até chegar ao primeiro nível em que nenhuma das colunas especificadas está presente.
  • A navegação começa na célula atual na matriz de dados, subindo a hierarquia. Se uma coluna especificada estiver em um nível inferior à célula atual, ela será desconsiderada.

Exemplo

Considerando uma tabela que resume as vendas totais de uma hierarquia com níveis totais, ano, trimestre e mês, os cálculos DAX a seguir buscam o valor de [SalesAmount] no nível pai, no nível de avô e no nível do ano ou do autonível, respectivamente.

DAX
ParentValue = COLLAPSE([SalesAmount], ROWS)
GrandParentValue = COLLAPSE([SalesAmount], ROWS, 2)
QuarterOrSelfValue = COLLAPSE([SalesAmount], [Month])

A captura de tela abaixo mostra a matriz com os três cálculos visuais.

de cálculo visual da DAX

Consulte também

EXPANDIR
EXPANDALL
COLLAPSEALL