WINDOW

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna várias linhas que estão posicionadas dentro de um determinado intervalo.

Sintaxe

WINDOW ( from[, from_type], to[, to_type][, <relation> or <axis>][, <orderBy>][, <blanks>][, <partitionBy>][, <matchBy>][, <reset>] )

Parâmetros

Termo	Definição
from	Indica onde a janela começa. Pode ser qualquer expressão DAX que retorna um valor escalar. O comportamento depende do parâmetro from_type: - Se from_type for REL, o número de linhas para voltar (valor negativo) ou avançar (valor positivo) da linha atual para obter a primeira linha na janela. - Se from_type é ABS, e from é positivo, então é a posição do início da janela desde o início da partição. A indexação é baseada em 1 e 0 é interpretado como 1. Por exemplo, 0 e 1 significam que a janela começa a partir do início da partição. Se from for negativo, então é a posição do início da janela a partir do final da partição. -1 significa a última linha da partição.
from_type	Modifica o comportamento do parâmetro from. Os valores possíveis são ABS (absoluto) e REL (relativo). O padrão é REL.
to	O mesmo que from, mas indica o fim da janela. A última linha está incluída na janela.
to_type	O mesmo que from_type, mas modifica o comportamento de to.
relation	(Opcional) Uma expressão de tabela a partir da qual as linhas de saída são retornadas. Se especificado, todas as colunas em partitionBy devem vir dele ou de uma tabela relacionada. Se omitido: - orderBy deve ser explicitamente especificado. - Todas as expressões orderBy e partitionBy devem ser nomes de colunas totalmente qualificados e provenientes de uma única tabela. - O padrão é ALLSELECTED() de todas as colunas em orderBy e partitionBy.
axis	(Opcional) Um eixo na forma visual. Disponível apenas em cálculos visuais e substitui relation.
orderBy	(Opcional) Uma cláusula ORDERBY() que contém as expressões que definem como cada partição é classificada. Se omitido: - relation deve ser explicitamente especificado. - O padrão é ordenar por cada coluna em relation que ainda não esteja especificado em partitionBy.
blanks	(Opcional) Uma enumeração que define como manipular valores em branco ao classificar o relation ou axis. Os valores suportados são: DEFAULT (o valor padrão), onde o comportamento para valores numéricos é valores em branco são ordenados entre zero e valores negativos. O comportamento para cadeias de caracteres é valores em branco são ordenados antes de todas as cadeias de caracteres, incluindo cadeias vazias. FIRST, os espaços em branco são sempre ordenados no início, independentemente da ordem de classificação crescente ou decrescente. LAST, os espaços em branco são sempre ordenados no final, independentemente da ordem de classificação crescente ou decrescente. Observe que, quando o parâmetro e os espaços em branco na função () em expressões individuais são especificados, na expressão orderBy individual tem prioridade para a expressão orderBy relevante, e as expressões orderBy sem serem especificadas honrarão o parâmetro na função pai.
partitionBy	(Opcional) Uma cláusula PARTITIONBY() que contém as colunas que definem como relation é particionada. Se omitido, relation é tratado como uma única partição.
matchBy	(Opcional) Uma cláusula MATCHBY() contendo as colunas que definem como corresponder dados e identificar a linha atual.
reset	(Opcional) Disponível apenas em cálculos visuais. Indica se o cálculo é redefinido e em que nível da hierarquia de colunas da forma visual. Os valores aceitos são: uma referência de campo a uma coluna na forma visual atual, NONE (padrão), LOWESTPARENT, HIGHESTPARENTou um inteiro. O comportamento depende do sinal inteiro: - Se zero ou omitido, o cálculo não é reiniciado. Equivalente a NONE. - Se positivo, o inteiro identifica a coluna a partir do mais alto, independente do grão. HIGHESTPARENT equivale a 1. - Se negativo, o inteiro identifica a coluna a partir do mais baixo, em relação ao grão atual. LOWESTPARENT é equivalente a -1.

Valor de retorno

Todas as linhas da janela.

Observações

Exceto para colunas adicionadas por DAX funções de tabela, cada coluna em relation, quando matchBy não está presente, ou cada coluna em matchBy e partitionBy, quando matchBy está presente, deve ter um valor externo correspondente para ajudar a definir a linha atual na qual operar. Se from_type e to_type tiverem valor ABS, o seguinte se aplica apenas às colunas partitionBy:

• Se houver exatamente uma coluna externa correspondente, seu valor será usado.
• Se não existir uma coluna exterior correspondente:
  • WINDOW primeiro determinará todas as colunas que não têm coluna externa correspondente.
  • Para cada combinação de valores existentes para essas colunas no contexto pai do WINDOW, WINDOW é avaliada e as linhas correspondentes são retornadas.
  • WINDOW saída final é uma união dessas linhas.
• Se houver mais de uma coluna externa correspondente, um erro será retornado.

Se todas as colunas do relationforam adicionadas por DAX funções da tabela, um erro será retornado.

Se matchBy estiver presente, WINDOW tentará usar matchBy e partitionBy colunas para identificar a linha. Se matchBy não estiver presente e as colunas especificadas em orderBy e partitionBy não puderem identificar exclusivamente todas as linhas relation, então:

• WINDOW tentará encontrar o menor número de colunas adicionais necessárias para identificar exclusivamente cada linha.
• Se essas colunas puderem ser encontradas, WINDOW acrescentará automaticamente essas novas colunas a orderBy, e cada partição será classificada usando esse novo conjunto de colunas orderBy.
• Se essas colunas não puderem ser encontradas, um erro será retornado.

Uma tabela vazia é retornada se:

• O valor externo correspondente de uma coluna orderBy ou partitionBy não existe dentro relation.
• Toda a janela está fora da partição, ou o início da janela é após o seu fim.

Se WINDOW for usado dentro de uma coluna calculada definida na mesma tabela que relatione orderBy for omitido, um erro será retornado.

Se o início da janela for antes da primeira linha, ela será definida como a primeira linha. Da mesma forma, se o final da janela estiver após a última linha da partição, ela será definida como a última linha.

reset pode ser usado apenas em cálculos visuais e não pode ser usado em combinação com orderBy ou partitionBy. Se reset estiver presente, axis pode ser especificado, mas relation não pode.

Exemplo 1 - medida

A seguinte medida:

3-day Average Price = 
AVERAGEX(
    WINDOW(
        -2,REL,0,REL,
        SUMMARIZE(ALLSELECTED('Sales'), 'Date'[Date], 'Product'[Product]),
        ORDERBY('Date'[Date]),
        KEEP,
        PARTITIONBY('Product'[Product])
    ), 
    CALCULATE(AVERAGE(Sales[Unit Price]))
)

Devolve a média de 3 dias dos preços unitários de cada produto. Observe que a janela de 3 dias consiste em três dias em que o produto tem vendas, não necessariamente três dias consecutivos.

Exemplo 2 - medida

A seguinte medida:

RunningSum =
SUMX (
    WINDOW (
        1, ABS, 0, REL,
        ALLSELECTED (
            'Date'[Fiscal Year],
            'Date'[Month Number Of Year]
        ),
        PARTITIONBY ( 'Date'[Fiscal Year] )
    ),
    [Total Sales]
)

Devolve a soma corrente do Total de Vendas por Número de Mês do Ano, reiniciando para cada Ano Fiscal:

Ano	Mês Número do Ano	Sales Amount	RunningSum
AF2018	1	$1.327.675	$1.327.675
AF2018	2	$3.936.463	$5.264.138
AF2018	3	$700.873	$5.965.011
AF2018	4	$1.519.275	$7.484.286
AF2018	5	$2.960.378	$10.444.664
AF2018	6	$1.487.671	$11.932.336
AF2018	7	$1.423.357	$13.355.693
AF2018	8	$2.057.902	$15.413.595
AF2018	9	$2.523.948	$17.937.543
AF2018	10	$561.681	$18.499.224
AF2018	11	$4.764.920	$23.264.145
AF2018	12	$596.747	$23.860.891
FY2019	1	$1.847.692	$1.847.692
FY2019	2	$2.829.362	$4.677.054
FY2019	3	$2.092.434	$6.769.488
FY2019	4	$2.405.971	$9.175.459
FY2019	5	$3.459.444	$12.634.903
FY2019	6	$2.850.649	$15.485.552
FY2019	7	$2.939.691	$18.425.243
FY2019	8	$3.964.801	$22.390.045
FY2019	9	$3.287.606	$25.677.650
FY2019	10	$2.157.287	$27.834.938
FY2019	11	$3.611.092	$31.446.030
FY2019	12	$2.624.078	$34.070.109
FY2020	1	$3.235.187	$3.235.187
FY2020	2	$4.070.046	$7.305.233
FY2020	3	$4.429.833	$11.735.066
FY2020	4	$4.002.614	$15.737.680
FY2020	5	$5.265.797	$21.003.477
FY2020	6	$3.465.241	$24.468.717
FY2020	7	$3.513.064	$27.981.781
FY2020	8	$5.247.165	$33.228.947
FY2020	9	$5.104.088	$38.333.035
FY2020	10	$3.542.150	$41.875.184
FY2020	11	$5.151.897	$47.027.081
FY2020	12	$4.851.194	$51.878.275

Exemplo 3 - cálculo visual

O seguinte cálculo visual DAX consulta:

TotalSalesRunningSumByYear = SUMX(WINDOW(0, ABS, 0, REL, ROWS, HIGHESTPARENT), [SalesAmount])

Devolve o total acumulado de vendas por mês, calculado ao longo de cada ano. Os valores 1 e -2 poderiam ser utilizados em vez de HIGHESTPARENT, com os mesmos resultados.

A captura de tela abaixo mostra a matriz visual e a expressão de cálculo visual:

Exemplo 4 - cálculo visual

O seguinte cálculo visual DAX consulta:

TotalSalesRunningSumByQuarter = SUMX(WINDOW(0, ABS, 0, REL, , -1), [SalesAmount])

Devolve o total acumulado de vendas por mês, calculado ao longo de cada trimestre.

Conteúdo relacionado

INDEX MOVINGAVERAGE OFFSET ORDERBY PARTITIONBY RANGE RANK ROWNUMBER RUNNINGSUM