View a markdown version of this page

Le proprietà degli asset di interrogazione si aggregano in AWS IoT SiteWise - AWS IoT SiteWise
Aggregati per una proprietà dell'asset (API)Aggregati per una proprietà dell'asset ()AWS CLI

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à.

Le proprietà degli asset di interrogazione si aggregano in AWS IoT SiteWise

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.

  • conteggio: il numero di punti dati per una proprietà in un intervallo di tempo.

  • massimo: il massimo dei valori di una proprietà in un intervallo di tempo.

  • minimo: il valore minimo 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, AWS IoT SiteWise calcola solo l'aggregato del conteggio.

Puoi anche calcolare parametri personalizzati per i dati di asset. Con le proprietà delle metriche, definisci aggregazioni specifiche per la tua operazione. Le proprietà delle metriche offrono funzioni di aggregazione e intervalli di tempo aggiuntivi non precalcolati per l'API. AWS IoT SiteWise Per ulteriori informazioni, consulta Aggrega i dati provenienti da proprietà e altre risorse (metriche).

Aggregati per una proprietà di asset (API)

Usa l' AWS IoT SiteWise API per ottenere aggregati per una proprietà dell'asset.

Usa l'GetAssetPropertyAggregatesoperazione per interrogare gli aggregati di una proprietà dell'asset.

Per identificare una proprietà dell'asset, specificate una delle seguenti opzioni:

  • La assetId fine propertyId della proprietà dell'asset a cui vengono inviati i dati.

  • ThepropertyAlias, 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. Gestisci i flussi di dati per AWS IoT SiteWise

È necessario passare i seguenti parametri obbligatori:

  • aggregateTypes— L'elenco degli aggregati da recuperare. Puoi specificare uno qualsiasi di AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION e SUM.

  • resolution— L'intervallo di tempo per il quale recuperare la metrica: 1m (1 minuto), 15m (15 minuti), 1h (1 ora) o 1d (1 giorno).

  • startDate— L'inizio esclusivo dell'intervallo da cui interrogare i dati storici, espresso in secondi in epoca Unix.

  • endDate— La fine inclusiva dell'intervallo da cui interrogare i dati storici, espressa in secondi in epoca Unix.

È anche possibile passare uno dei seguenti parametri per perfezionare i risultati:

  • maxResults— Il numero massimo di risultati da restituire in una richiesta. Il valore predefinito è «risultati». 20

  • nextToken— Un token di paginazione 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 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à dell'asset (AWS CLI)

Per interrogare gli aggregati relativi a una proprietà dell'asset (AWS CLI)

  1. 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. Sostituisci asset-id con l'ID dell'asset e property-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-id property-id \
  --start-date 1575216000 \
  --end-date 1575219600 \
  --aggregate-types AVERAGE SUM \
  --resolution 1h

    L'operazione restituisce una risposta contenente i TQV storici 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"
}

  2. Se esistono più voci di valore, puoi passare il token di paginazione dal nextToken campo a una successiva chiamata all'GetAssetPropertyAggregatesoperazione.

Nota

Se l'intervallo di query contiene un null valore TQvS, consulta API. AssetPropertyValue Tutte le statistiche, tranne il conteggio, danno come risultato una null risposta, simile alle statistiche per String TQV. Se l'intervallo di interrogazione contiene Double.NaN TQV di tipo doppio, tutti i calcoli tranne il conteggio daranno come risultato un. Double.NaN