windowAvg

Die Funktion windowAvg berechnet den Durchschnitt des aggregierten Messwerts in einem benutzerdefinierten Fenster, das nach bestimmten Attributen partitioniert und sortiert ist. In der Regel verwenden Sie benutzerdefinierte Fensterfunktionen auf einer Zeitreihe, bei der Ihre Visualisierung eine Metrik und ein Datumsfeld anzeigt. Sie können beispielsweise windowAvg verwenden, um einen gleitenden Durchschnitt zu berechnen – häufig verwendet, um Rauschen in einem Liniendiagramm zu glätten.

Fensterfunktionen werden nicht für MySQL-Versionen vor Version 8 und MariaDB-Versionen vor Version 10.2 unterstützt.

Syntax

Die Klammern sind erforderlich. Welche Argumente optional sind, erfahren Sie in den folgenden Beschreibungen.

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

Argumente

measure

Die aggregierte Metrik, für die Sie den Durchschnitt erhalten möchten, z. B. sum({Revenue}).

Attribute sortieren

Eines oder mehrere aggregierte Felder (Messwerte und/oder Dimensionen), nach denen Sie die Daten sortieren möchten, getrennt durch Kommas. Sie können aufsteigend (ASC) oder absteigend (DESC) sortieren.

Jedes Feld in der Liste ist von { } (geschweifte Klammern) eingeschlossen, wenn es mehr als ein Wort umfasst. Die gesamte Liste ist in [ ] (eckige Klammern) eingeschlossen.

Startindex

Der Startindex ist eine positive Ganzzahl, die n Zeilen oberhalb der aktuellen Zeile anzeigt. Der Startindex zählt die verfügbaren Datenpunkte oberhalb der aktuellen Zeile, anstatt tatsächliche Zeiträume zu zählen. Sind Ihre Daten unvollständig (beispielsweise fehlende Monate oder Jahre), passen Sie die Indizes entsprechend an.

Endindex

Der Endindex ist eine positive Ganzzahl, die n Zeilen unterhalb der aktuellen Zeile anzeigt. Der Endindex zählt die verfügbaren Datenpunkte unterhalb der aktuellen Zeile anstelle der tatsächlichen Zeiträume. Sind Ihre Daten unvollständig (beispielsweise fehlende Monate oder Jahre), passen Sie die Indizes entsprechend an.

partition field

(Optional) Eine oder mehrere Dimensionen, nach denen Sie die Daten partitionieren möchten, getrennt durch Kommas.

Jedes Feld in der Liste ist von { } (geschweifte Klammern) eingeschlossen, wenn es mehr als ein Wort umfasst. Die gesamte Liste ist in [ ] (eckige Klammern) eingeschlossen.

Beispiel

Das folgende Beispiel berechnet den gleitenden Durchschnitt von sum(Revenue), partitioniert nach SaleDate. Die Berechnung umfasst drei Zeilen oben und zwei Zeilen unterhalb der aktuellen Zeile.

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

Die folgende Abbildung zeigt das Ergebnis des Beispiels für einen gleitenden Durchschnitt. Das Feld Summe (Umsatz) wird dem Diagramm hinzugefügt, um die Differenz zwischen dem Umsatz und dem gleitenden Durchschnitt des Umsatzes anzuzeigen.