As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
windowMax
A função windowMax
calcula o máximo 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. Use windowMax
para ajudar você a identificar o máximo da métrica durante um período.
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.
windowMax (
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 o máximo nos últimos 12 meses de sum(Revenue)
, particionado por SaleDate
. O cálculo inclui 12 linhas acima e nenhuma linha abaixo da linha atual.
windowMax ( sum(Revenue), [SaleDate ASC], 12, 0 )
A captura de tela a seguir mostra os resultados desse exemplo dos últimos 12 meses. O campo sum(Revenue) é adicionado ao gráfico para mostrar a diferença entre a receita e a receita máxima dos últimos 12 meses.
![Line graph showing revenue growth from 2017 to 2018, with a sharp decline in late 2018.](images/windowMax.png)