View a markdown version of this page

Fragen Sie Aggregate von Anlageneigenschaften ab in AWS IoT SiteWise - AWS IoT SiteWise
Aggregate für eine Anlageneigenschaft (API)Aggregate für eine Vermögensimmobilie ()AWS CLI

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.

Fragen Sie Aggregate von Anlageneigenschaften ab in AWS IoT SiteWise

AWS IoT SiteWise berechnet automatisch aggregierte Anlageneigenschaftswerte, bei denen es sich um eine Reihe grundlegender Kennzahlen handelt, die über mehrere Zeitintervalle berechnet werden. AWS IoT SiteWise berechnet pro Minute, Stunde und Tag die folgenden Aggregationen für Ihre Asset-Eigenschaften:

  • Durchschnitt — Der Durchschnitt (Mittelwert) der Werte einer Immobilie über ein Zeitintervall.

  • Anzahl — Die Anzahl der Datenpunkte für eine Eigenschaft in einem Zeitintervall.

  • Maximum — Das Maximum der Werte einer Eigenschaft über ein Zeitintervall.

  • Minimum — Das Minimum der Werte einer Eigenschaft über ein Zeitintervall.

  • Standardabweichung — Die Standardabweichung der Werte einer Eigenschaft über ein Zeitintervall.

  • Summe — Die Summe der Werte einer Eigenschaft über ein Zeitintervall.

Für nicht numerische Eigenschaften wie Zeichenketten und boolesche Werte wird nur das Aggregat für die AWS IoT SiteWise Anzahl berechnet.

Sie können für Ihre Komponentendaten auch benutzerdefinierte Metriken berechnen. Mit metrischen Eigenschaften definieren Sie Aggregationen, die für Ihren Vorgang spezifisch sind. Metrikeigenschaften bieten zusätzliche Aggregationsfunktionen und Zeitintervalle, die für die API nicht vorberechnet wurden. AWS IoT SiteWise Weitere Informationen finden Sie unter Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken).

Aggregate für eine Asset-Eigenschaft (API)

Verwenden Sie die AWS IoT SiteWise API, um Aggregate für eine Asset-Eigenschaft abzurufen.

Verwenden Sie die GetAssetPropertyAggregates Operation, um Aggregate einer Anlageneigenschaft abzufragen.

Um eine Anlageneigenschaft zu identifizieren, geben Sie eine der folgenden Optionen an:

  • Das assetId Ende propertyId der Asset-Eigenschaft, an die Daten gesendet werden.

  • ThepropertyAlias, bei dem es sich um einen Datenstream-Alias handelt (z. B./company/windfarm/3/turbine/7/temperature). Um diese Option verwenden zu können, müssen Sie zuerst den Alias der Komponenteneigenschaft festlegen. Informationen zum Festlegen von Eigenschaftsaliasen finden Sie unterDatenströme verwalten für AWS IoT SiteWise.

Sie müssen die folgenden erforderlichen Parameter übergeben:

  • aggregateTypes— Die Liste der abzurufenden Aggregate. Sie können AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION oder SUM angeben.

  • resolution— Das Zeitintervall, für das die Metrik abgerufen werden soll: 1m (1 Minute), 15m (15 Minuten), 1h (1 Stunde) oder 1d (1 Tag).

  • startDate— Der exklusive Beginn des Bereichs, aus dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in Unix-Epochenzeit.

  • endDate— Das inklusive Ende des Bereichs, ab dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in Unix-Epochenzeit.

Sie können auch einen der folgenden Parameter übergeben, um Ihre Ergebnisse zu verfeinern:

  • maxResults— Die maximale Anzahl von Ergebnissen, die in einer Anfrage zurückgegeben werden sollen. Standardmäßig sind 20 Ergebnisse.

  • nextToken— Ein Paginierungstoken, das von einem früheren Aufruf dieser Operation zurückgegeben wurde.

  • timeOrdering— Die Reihenfolge, die auf die zurückgegebenen Werte angewendet werden soll: ASCENDING oderDESCENDING.

  • qualities— Die Qualität, nach der die Ergebnisse gefiltert werden GOOD sollen:BAD, oderUNCERTAIN.

Anmerkung

Die GetAssetPropertyAggregates Operation gibt ein TQV mit einem anderen Format als andere in diesem Abschnitt beschriebene Operationen zurück. Die value-Struktur enthält ein Feld für jeden der aggregateTypes in der Anforderung. Der timestamp enthält die Zeit in Sekunden in Unix-Epoche-Zeit, zu der die Aggregation stattfand.

Aggregate für eine Anlageneigenschaft (AWS CLI)

Um Aggregate für eine Anlageneigenschaft abzufragen (AWS CLI)

  1. Führen Sie den folgenden Befehl aus, um Aggregate für die Komponenteneigenschaft abzurufen. Dieser Befehl fragt den Durchschnitt und die Summe mit einer Auflösung von 1 Stunde für ein bestimmtes Intervall von 1 Stunde ab. asset-idErsetzen Sie durch die ID des Assets und property-id durch die ID der Eigenschaft. Ersetzen Sie die Parameter durch die Aggregate und das abzufragende Intervall.

    aws iotsitewise get-asset-property-aggregates \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575219600 \
  --aggregate-types AVERAGE SUM \
  --resolution 1h

    Die Operation gibt eine Antwort mit den historischen TQVs der Eigenschaft im folgenden Format zurück. Die Antwort enthält nur die angeforderten Aggregate.

    {
  "aggregatedValues": [
    {
      "timestamp": Number,
      "quality": "String",
      "value": {
        "average": Number,
        "count": Number,
        "maximum": Number,
        "minimum": Number,
        "standardDeviation": Number,
        "sum": Number
      }
    }
  ],
  "nextToken": "String"
}

  2. Wenn mehrere Werteinträge vorhanden sind, können Sie das Paginierungstoken aus dem nextToken Feld an einen nachfolgenden Aufruf der GetAssetPropertyAggregates Operation übergeben.

Anmerkung

Wenn Ihr Abfragebereich einen null Wert TQVs enthält, siehe AssetPropertyValue API. Alle Statistiken außer count führen zu einer null Antwort, ähnlich den Statistiken für String-TQVs. Wenn Ihr Abfragebereich TQVs vom Typ Double enthältDouble.NaN, führen alle Berechnungen außer der Anzahl zu einem Ergebnis. Double.NaN