Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Interroga gli aggregati delle proprietà degli asset
AWS IoT SiteWise calcola automaticamente i valori aggregati delle proprietà degli asset, che sono un insieme di metriche di base calcolate su più intervalli di tempo. AWS IoT SiteWise calcola i seguenti aggregati ogni minuto, ora e giorno per le proprietà degli asset:
-
media: la media (media) dei valori di una proprietà in un intervallo di tempo.
-
count: il numero di punti dati per una proprietà in un intervallo di tempo.
-
maximum — Il massimo dei valori di una proprietà in un intervallo di tempo.
-
minimo — Il minimo dei valori di una proprietà in un intervallo di tempo.
-
deviazione standard: la deviazione standard dei valori di una proprietà in un intervallo di tempo.
-
sum — La somma dei valori di una proprietà in un intervallo di tempo.
Per le proprietà non numeriche, come stringhe e valori booleani, calcola solo l'aggregato di conteggio. AWS IoT SiteWise
Puoi anche calcolare parametri personalizzati per i dati di asset. Con le proprietà metriche, definisci aggregazioni specifiche per la tua operazione. Le proprietà metriche offrono funzioni di aggregazione e intervalli di tempo aggiuntivi che non sono precalcolati per. AWS IoT SiteWise API Per ulteriori informazioni, consulta Aggrega i dati provenienti da proprietà e altre risorse (metriche).
Aggregati per una proprietà di asset () API
Puoi utilizzare il AWS IoT SiteWise API per ottenere gli aggregati per una proprietà dell'asset.
Utilizzate l'GetAssetPropertyAggregatesoperazione per interrogare gli aggregati di una proprietà di un asset.
Per identificare la proprietà di un asset, specificate una delle seguenti opzioni:
-
La proprietà
assetId
epropertyId
della risorsa a cui vengono inviati i dati. -
Il
propertyAlias
, che è un alias del flusso di dati (ad esempio,/company/windfarm/3/turbine/7/temperature
). Per utilizzare questa opzione, è necessario prima impostare l'alias della proprietà dell'asset. Per impostare gli alias delle proprietà, vedere. Mappa i flussi di dati industriali sulle proprietà degli asset
È inoltre necessario passare i seguenti parametri obbligatori:
-
aggregateTypes
— L'elenco degli aggregati da recuperare. Puoi specificare uno qualsiasi diAVERAGE
,COUNT
,MAXIMUM
,MINIMUM
,STANDARD_DEVIATION
eSUM
. -
resolution
— L'intervallo di tempo per il quale recuperare la metrica:1m
(1 minuto), (1 ora) o1h
1d
(1 giorno). -
startDate
— L'inizio esclusivo dell'intervallo da cui interrogare i dati storici, espresso in secondi nell'epoca Unix. -
endDate
— La fine inclusiva dell'intervallo da cui interrogare i dati storici, espressa in secondi nell'epoca Unix.
È anche possibile passare uno dei seguenti parametri per perfezionare i risultati:
-
maxResults
— Il numero massimo di risultati da restituire in una richiesta. I valori predefiniti sono i risultati.20
-
nextToken
— Un token di impaginazione restituito da una precedente chiamata di questa operazione. -
timeOrdering
— L'ordine da applicare ai valori restituiti:ASCENDING
o.DESCENDING
-
qualities
— La qualità per filtrare i risultati in base a:GOOD
BAD
, oUNCERTAIN
.
Nota
L'GetAssetPropertyAggregatesoperazione restituisce un TQV messaggio con un formato diverso rispetto alle altre operazioni descritte in questa sezione. La struttura di value
annovera un campo per ogni aggregateTypes
incluso nella richiesta. timestamp
contiene l'orario in cui si è verificata l'aggregazione, in secondi nel formato epoca (Unix epoch).
Aggregati per una proprietà di asset ()AWS CLI
Per interrogare gli aggregati per una proprietà di un asset ()AWS CLI
-
Esegui il comando seguente per ottenere aggregati per la proprietà di asset. Questo comando esegue la query per la media e la somma con una risoluzione di 1 ora per uno specifico intervallo di 1 ora. Replace (Sostituisci)
asset-id
con l'ID della risorsa eproperty-id
con l'ID della proprietà. Sostituisci i parametri con gli aggregati e l'intervallo per la query.aws iotsitewise get-asset-property-aggregates \ --asset-id
asset-id
\ --property-idproperty-id
\ --start-date1575216000
\ --end-date1575219600
\ --aggregate-typesAVERAGE SUM
\ --resolution1h
L'operazione restituisce una risposta che contiene lo storico TQVs della proprietà nel formato seguente. La risposta include solo gli aggregati richiesti.
{ "aggregatedValues": [ { "timestamp":
Number
, "quality": "String
", "value": { "average":Number
, "count":Number
, "maximum":Number
, "minimum":Number
, "standardDeviation":Number
, "sum":Number
} } ], "nextToken": "String
" } -
Se esistono più valori, è possibile passare il token di impaginazione dal
nextToken
campo a una successiva chiamata all'GetAssetPropertyAggregatesoperazione.