windowMax

Die Funktion windowMax berechnet das Maximum 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 windowMax verwenden, um das Maximum der Metrik über einen bestimmten Zeitraum zu identifizieren.

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.

windowMax
	(
	     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 in {} eingeschlossen (geschweifte Klammern), wenn es mehr als ein Wort umfasst. Die gesamte Liste ist in [ ] (eckige Klammern) eingeschlossen.

Beispiel

Das folgende Beispiel berechnet das Maximum der vergangenen zwölf Monate von sum(Revenue), partitioniert nach SaleDate. Die Berechnung umfasst 12 Zeilen oberhalb und 0 Zeilen unterhalb der aktuellen Zeile.

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

Der folgende Screenshot zeigt die Ergebnisse dieses Beispiels für die letzten zwölf Monate. Das Feld Summe (Umsatz) wird dem Diagramm hinzugefügt, um die Differenz zwischen dem Umsatz und dem Maximum der vergangenen zwölf Monate anzuzeigen.