Medidas de janela em coluna de índice numérico nas views de métrica

Para que serve

Imagine que você precisa calcular tendências ou comparações em períodos que não seguem o calendário tradicional — como semanas fiscais, semanas ISO ou períodos contábeis 4-4-5. Com esta atualização, as medidas de janela (window measures) em views de métrica passam a suportar parâmetros de intervalo (range) e deslocamento (offset) numéricos e sem unidade sobre colunas de índice inteiro.

Isso permite:

• Calcular médias móveis ou totais acumulados usando posições inteiras sequenciais.
• Fazer comparações de períodos usando índices numéricos em vez de datas do calendário.
• Definir janelas flexíveis baseadas em sequências numéricas densas.

Como usar

Você configura a medida de janela apontando para uma coluna de índice inteiro e aplicando um intervalo ou offset numérico, garantindo que colunas de dependência usem a especificação range: all.

version: 1.1
source: main.default.financial_data
fields:
  - name: fiscal_year
    expr: fiscal_year
  - name: fiscal_period
    expr: fiscal_period
  - name: period_index
    expr: fiscal_year * 12 + fiscal_period
    window:
      - order: period_index
        range: all
measures:
  - name: rolling_sales
    expr: SUM(sales)
    window:
      - order: period_index
        range: trailing 3
        semiadditive: last

O que acontece nesse código:

1. A versão especificada do YAML é a 1.1.
2. A fonte de dados aponta para uma tabela de dados financeiros.
3. O campo period_index é derivado combinando ano e período fiscal, com range: all para evitar particionamento indevido.
4. A medida rolling_sales soma as vendas usando uma janela deslizante de 3 posições inteiras anteriores.

Limitações e requisitos

• Requer Databricks Runtime 19 ou superior e versão de especificação YAML 1.1 ou superior.
• A coluna de índice deve ser integral (TINYINT, SMALLINT, INT ou BIGINT), monótona e consecutiva (densa), sem lacunas ou repetições.