windowAvg
A função windowAvg calcula a média da medida agregada em uma janela personalizada que está particionada e classificada por atributos especificados. Normalmente, as funções de janela personalizada são usadas em uma série temporal, na qual o visual exibe uma métrica e um campo de data. Por exemplo, você pode usar windowAvg para calcular uma média móvel, que normalmente é usada para suavizar o ruído em um gráfico de linha.
As funções de janela não são compatíveis com versões do MySQL anteriores à 8 e versões do MariaDB anteriores à 10.2.
Sintaxe
São necessários colchetes. Para ver quais argumentos são opcionais, consulte as seguintes descrições.
windowAvg (measure,[sort_order_field ASC/DESC, ...],start_index,end_index,[ partition_field, ... ])
Argumentos
- medida
-
A métrica agregada para a qual você deseja obter a média, por exemplo,
sum({Revenue}). - atributo de classificação
-
Um ou mais campos agregados, medidas ou dimensões ou ambas, pelas quais deseja classificar os dados, separados por vírgulas. Você pode especificar ordem de classificação crescente (
ASC) ou decrescente (DESC).Cada campo na lista está entre chaves ({}), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).
- índice de início
-
O índice de início é um inteiro positivo, indicando n linhas acima da linha atual. O índice de início conta os pontos de dados disponíveis acima da linha atual, em vez de contar os períodos em si. Se os dados estiverem dispersos (meses ou anos ausentes, por exemplo), ajuste os índices de acordo.
- índice de término
-
O índice de término é um inteiro positivo, indicando n linhas abaixo da linha atual. O índice de término conta os pontos de dados disponíveis abaixo da linha atual, em vez de contar os períodos em si. Se os dados estiverem dispersos (meses ou anos ausentes, por exemplo), ajuste os índices de acordo.
- campo de partição
-
(Opcional) Uma ou mais dimensões pelas quais deseja particionar, separadas por vírgulas.
Cada campo na lista está entre chaves ({}), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).
Exemplo
O exemplo a seguir calcula a média móvel de sum(Revenue), particionada por SaleDate. O cálculo inclui três linhas acima e duas linhas abaixo da linha atual.
windowAvg ( sum(Revenue), [SaleDate ASC], 3, 2 )
A captura de tela a seguir mostra os resultados desse exemplo de média móvel. O campo sum(Revenue) é adicionado ao gráfico para mostrar a diferença entre a receita e a média móvel da receita.
