Abfragen von Aggregaten für Asset-Eigenschaften - AWS IoT SiteWise
Aggregate für eine Anlageimmobilie () APIAggregate 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 Aggregaten für Asset-Eigenschaften

AWS IoT SiteWise berechnet automatisch aggregierte Immobilienwerte. Dabei handelt es sich um eine Reihe von Basiskennzahlen, 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 nicht im Voraus für die berechnet wurden. AWS IoT SiteWise API Weitere Informationen finden Sie unter Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken).

Aggregate für eine Anlageeigenschaft () API

Sie können die verwenden AWS IoT SiteWise API, um Aggregate für eine Anlageeigenschaft 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 unterOrdnen Sie industrielle Datenströme den Eigenschaften von Anlagen zu.

Sie müssen auch 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), 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 der 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 a TQV zurück, deren 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. Ersetzen asset-id mit der ID der Anlage und property-id mit der 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

    Die Operation 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, können Sie das Paginierungstoken aus dem nextToken Feld an einen nachfolgenden Aufruf der GetAssetPropertyAggregatesOperation übergeben.