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
EndepropertyId
der Anlageneigenschaft, an die Daten gesendet werden. -
The
propertyAlias
, 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önnenAVERAGE
,COUNT
,MAXIMUM
,MINIMUM
,STANDARD_DEVIATION
oderSUM
angeben. -
resolution
— Das Zeitintervall, für das die Metrik abgerufen werden soll:1m
(1 Minute),1h
(1 Stunde) oder1d
(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 werden20
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:GOOD
BAD
,, 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
-
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 undproperty-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-idproperty-id
\ --start-date1575216000
\ --end-date1575219600
\ --aggregate-typesAVERAGE SUM
\ --resolution1h
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
" } -
Wenn mehr Werteinträge vorhanden sind, können Sie das Paginierungstoken aus dem
nextToken
Feld an einen nachfolgenden Aufruf der GetAssetPropertyAggregatesOperation übergeben.