View a markdown version of this page

Verwenden Sie Aggregationsfunktionen in Formelausdrücken - AWS IoT SiteWise

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie Aggregationsfunktionen in Formelausdrücken

Nur für Metriken können Sie die folgenden Funktionen verwenden, die Eingabewerte über jedes Zeitintervall aggregieren und einen einzelnen Ausgabewert berechnen. Einige Aggregationsfunktionen können keine Daten aus zugeordneten Komponenten aggregieren.

Argumente für Aggregationsfunktionen können Variablen, Zahlenliterale, temporale Funktionen , verschachtelte Ausdrücke oder Aggregationsfunktionen sein. Die Formel max(latest(x), latest(y), latest(z)) verwendet eine Aggregationsfunktion als Argument und gibt den größten aktuellen Wert der z Eigenschaftenx,y, und zurück.

Sie können verschachtelte Ausdrücke in Aggregationsfunktionen verwenden. Wenn Sie verschachtelte Ausdrücke verwenden, gelten die folgenden Regeln:

  • Jedes Argument kann nur eine Variable haben.

    Beispiel

    Zum Beispiel avg(x*(x-1)) und sum(x/2 )/avg(y^2 ) werden unterstützt.

    Zum Beispiel wird min(x/y) nicht unterstützt.

  • Jedes Argument kann mehrstufige verschachtelte Ausdrücke enthalten.

    Beispiel

    Zum Beispiel sum(avg(x^2 )/2) wird unterstützt.

  • Verschiedene Argumente können unterschiedliche Variablen haben.

    Beispiel

    Zum Beispiel sum(x/2, y*2) wird unterstützt.

Anmerkung

  • Wenn Ihre Ausdrücke Messwerte enthalten, werden die letzten Werte im aktuellen Zeitintervall für die Messungen AWS IoT SiteWise verwendet, um Aggregate zu berechnen.

  • Wenn Ihre Ausdrücke Attribute enthalten, werden die neuesten Werte für die Attribute AWS IoT SiteWise verwendet, um Aggregate zu berechnen.

Funktion Description

avg(x0, ..., xn)

Gibt den Mittelwert der angegebenen Variablen werte über das aktuelle Zeitintervall zurück.

Diese Funktion gibt nur dann einen Datenpunkt aus, wenn die angegebenen Variablen im aktuellen Zeitintervall mindestens einen Datenpunkt haben.

sum(x0, ..., xn)

Gibt die Summe der angegebenen Variablenwerte über das aktuelle Zeitintervall zurück.

Diese Funktion gibt nur dann einen Datenpunkt aus, wenn die angegebenen Variablen mindestens einen Datenpunkt im aktuellen Zeitintervall haben.

min(x0, ..., xn)

Gibt den Mindestwert der angegebenen Variablenwerte über das aktuelle Zeitintervall zurück.

Diese Funktion gibt nur dann einen Datenpunkt aus, wenn die angegebenen Variablen mindestens einen Datenpunkt im aktuellen Zeitintervall haben.

max(x0, ..., xn)

Gibt den Höchstwert der angegebenen Variablenwerte über das aktuelle Zeitintervall zurück.

Diese Funktion gibt nur dann einen Datenpunkt aus, wenn die angegebenen Variablen mindestens einen Datenpunkt im aktuellen Zeitintervall haben.

count(x0, ..., xn)

Gibt die Gesamtanzahl der Datenpunkte für die angegebenen Variablen über das aktuelle Zeitintervall zurück. Weitere Informationen zum Zählen der Datenpunkte, die eine Bedingung erfüllen, finden Sie unter Zählen Sie Datenpunkte, die einer Bedingung entsprechen.

Diese Funktion berechnet einen Datenpunkt für jedes Zeitintervall.

stdev(x0, ..., xn)

Gibt die Standardabweichung der Werte der angegebenen Variablen über das aktuelle Zeitintervall zurück.

Diese Funktion gibt nur dann einen Datenpunkt aus, wenn die angegebenen Variablen im aktuellen Zeitintervall mindestens einen Datenpunkt haben.