windowMax

La fonction windowMax calcule le maximum de la mesure regroupée dans une fenêtre personnalisée qui est divisée et triée par les attributs spécifiés. En règle générale, vous utilisez les fonctions de fenêtrage personnalisé sur une série chronologique, dans laquelle votre représentation visuelle affiche une métrique et un champ de date. Vous pouvez utiliser windowMax pour vous aider à identifier le maximum de la métrique sur une période de temps.

Les fonctions de fenêtrage ne sont pas prises en charge pour les versions MySQL antérieures à 8 et pour les versions MariaDB antérieures à 10.2.

Syntaxe

Les crochets sont obligatoires. Pour voir quels arguments sont facultatifs, consultez les descriptions suivantes.

windowMax
	(
	     measure 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)

Arguments

measure

Les métriques regroupées pour lesquelles vous souhaitez obtenir la moyenne, par exemple sum({Revenue}).

trier attribut

Un ou plusieurs champs regroupés, des mesures ou des dimensions ou les deux, selon lesquels vous souhaitez trier les données, avec séparation par des virgules. Vous pouvez spécifier un ordre de tri croissant (ASC) ou décroissant (DESC).

Chaque champ de la liste est placé dans des accolades {}, s'il s'agit de plusieurs mots. La liste entière est placée entre crochets [ ].

index de début

L'index de début est un entier positif indiquant n lignes au-dessus de la ligne actuelle. L'index de début comptabilise les points de données disponibles au-dessus de la ligne actuelle, au lieu de compter les périodes réelles. Si vos données sont fragmentées (mois ou années manquants, par exemple), ajustez les index en conséquence.

index de fin

L'index de fin est un entier positif indiquant n lignes en dessous de la ligne actuelle. L'index de fin comptabilise les points de données disponibles en dessous de la ligne actuelle, au lieu de compter les périodes réelles. Si vos données sont fragmentées (mois ou années manquants, par exemple), ajustez les index en conséquence.

partition field

(Facultatif) Une ou plusieurs mesures et dimensions selon lesquelles vous souhaitez effectuer la partition, avec séparation par des virgules.

Chaque champ de la liste est placé dans des accolades {}, s'il s'agit de plusieurs mots. La liste entière est placée entre crochets [ ].

Exemple

L'exemple suivant calcule le maximum sur 12 mois de sum(Revenue), partitionné par SaleDate. Le calcul comprend 12 lignes au-dessus et 0 lignes en dessous de la ligne actuelle.

windowMax
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     12,
               0
	) 

La capture d'écran suivante affiche les résultats de cet exemple sur 12 mois. Le champ somme (Revenu) est ajouté au graphique pour montrer la différence entre le revenu et les revenus maximum sur la période de 12 mois.