windowAvg

La fonction windowAvg calcule la moyenne 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. Par exemple, vous pouvez utiliser windowAvg pour calculer une moyenne mobile, qui est souvent utilisée pour lisser le bruit dans un graphique en aires.

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.

windowAvg
	(
	     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 la moyenne mobile de sum(Revenue), partitionnée selon SaleDate. Le calcul comprend trois lignes au-dessus et deux lignes en dessous de la ligne actuelle.

windowAvg
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     3,
            2
	) 

La capture d'écran suivante affiche les résultats de cet exemple de moyenne mobile. Le champ somme (Revenu) est ajouté au graphique pour montrer la différence entre le revenu et la moyenne mobile des revenus.