COLLAPSE
aplica-se a:
coluna calculadatabela calculadamedida
cá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.
COLLAPSE ( <expression>, <axis>[, N] )
COLLAPSE ( <expression>, <column>[, <column>] ... )
As sintaxes que executam somente navegação.
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 o total de vendas de uma hierarquia com níveis para total, ano, trimestre e mês, os cálculos de DAX a seguir buscam o valor de [SalesAmount] no nível pai, no nível de avô e no nível de ano ou auto, respectivamente.
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