Abfragen von Asset-Eigenschaftenaggregaten in AWS IoT SiteWise - AWS IoT SiteWise
Aggregate für eine Anlageneigenschaft (API)Aggregate für eine Anlageimmobilie ()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.

Abfragen von Asset-Eigenschaftenaggregaten in AWS IoT SiteWise

AWS IoT SiteWise berechnet automatisch aggregierte Immobilienwerte, bei denen es sich um eine Reihe von Basiskennzahlen handelt, die über mehrere Zeitintervalle berechnet werden. AWS IoT SiteWise berechnet jede Minute, Stunde und Tag die folgenden Aggregate für Ihre Anlageeigenschaften:

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

  • Anzahl — Die Anzahl der Datenpunkte für eine Eigenschaft über ein 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. Metrische Eigenschaften bieten zusätzliche Aggregationsfunktionen und Zeitintervalle, die für die API nicht im Voraus berechnet wurden. AWS IoT SiteWise Weitere Informationen finden Sie unter Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken).

Aggregate für eine Anlageneigenschaft (API)

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

Verwenden Sie die GetAssetPropertyAggregatesOperation, um Aggregate einer Anlageneigenschaft abzufragen.

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

  • Das assetId Ende propertyId der Anlageneigenschaft, 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 Eigenschaftsaliasnamen 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 ausschließliche Anfang des Bereichs, aus dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in Unix-Epochenzeit.

  • endDate— Das inklusive Ende des Bereichs, aus dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in der 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 werden 20 Ergebnisse verwendet.

  • 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 Ergebnisse gefiltert werden sollen nach: GOODBAD,, oderUNCERTAIN.

Anmerkung

Die GetAssetPropertyAggregatesOperation gibt ein TQV zurück, dessen Format sich von den anderen in diesem Abschnitt beschriebenen Operationen unterscheidet. 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 Anlageeigenschaft ()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 der Anlage und property-id durch die ID der Immobilie. 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

    Der Vorgang gibt eine Antwort zurück, die den TQVs Verlauf der Eigenschaft im folgenden Format enthält. 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 mehr Werteinträge vorhanden sind, übergeben Sie das Paginierungstoken aus dem nextToken Feld an einen nachfolgenden Aufruf der GetAssetPropertyAggregatesOperation.

Anmerkung

Wenn Ihr Abfragebereich einen null Wert enthält TQVs, finden Sie weitere Informationen unter AssetPropertyValueAPI. Alle Statistiken außer count führen zu einer null Antwort, ähnlich den Statistiken für String TQVs. Wenn Ihr Abfragebereich Double.NaN den Typ „Double“ enthält TQVs, führen alle Berechnungen außer count zu einemDouble.NaN.