Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Rechercher des agrégats de propriétés d'actifs
AWS IoT SiteWise calcule automatiquement les valeurs agrégées des propriétés des actifs, qui sont un ensemble de mesures de base calculées sur plusieurs intervalles de temps. AWS IoT SiteWise calcule les agrégats suivants chaque minute, heure et jour pour les propriétés de vos actifs :
-
average — La moyenne (moyenne) des valeurs d'une propriété sur un intervalle de temps.
-
count — Le nombre de points de données pour une propriété sur un intervalle de temps.
-
maximum — Le maximum des valeurs d'une propriété sur un intervalle de temps.
-
minimum : valeur minimale d'une propriété sur un intervalle de temps.
-
écart type : écart type des valeurs d'une propriété sur un intervalle de temps.
-
sum — Somme des valeurs d'une propriété sur un intervalle de temps.
Pour les propriétés non numériques, telles que les chaînes et les booléens, AWS IoT SiteWise calcule uniquement le nombre agrégé.
Vous pouvez également calculer des métriques personnalisées pour vos données d'actif. Les propriétés des métriques vous permettent de définir des agrégations spécifiques à votre opération. Les propriétés métriques offrent des fonctions d'agrégation et des intervalles de temps supplémentaires qui ne sont pas précalculés pour le AWS IoT SiteWise API. Pour de plus amples informations, veuillez consulter Données agrégées provenant de propriétés et d'autres actifs (métriques).
Agrégats pour une propriété d'actif () API
Vous pouvez utiliser le AWS IoT SiteWise API pour obtenir des agrégats pour une propriété d'actif.
Utilisez l'GetAssetPropertyAggregatesopération pour interroger les agrégats d'une propriété d'actif.
Pour identifier une propriété d'actif, spécifiez l'une des options suivantes :
-
La
assetId
finpropertyId
de la propriété de l'actif à laquelle les données sont envoyées. -
Le
propertyAlias
, qui est un alias de flux de données (par exemple,/company/windfarm/3/turbine/7/temperature
). Pour utiliser cette option, vous devez d'abord définir l'alias de votre propriété de ressource. Pour définir des alias de propriété, consultezMappez les flux de données industriels aux propriétés des actifs.
Vous devez également passer les paramètres obligatoires suivants :
-
aggregateTypes
— La liste des agrégats à récupérer. Vous pouvez spécifier n'importe quel élément :AVERAGE
,COUNT
,MAXIMUM
,MINIMUM
,STANDARD_DEVIATION
etSUM
. -
resolution
— Intervalle de temps pendant lequel la métrique doit être1m
récupérée : (1 minute),1h
(1 heure) ou1d
(1 jour). -
startDate
— Le début exclusif de la plage à partir de laquelle interroger les données historiques, exprimé en secondes à l'époque Unix. -
endDate
— La fin de la plage inclusive à partir de laquelle interroger les données historiques, exprimée en secondes à l'époque Unix.
Vous pouvez également passer l'un des paramètres suivants pour affiner vos résultats :
-
maxResults
— Le nombre maximum de résultats à renvoyer en une seule demande. Par défaut, ce sont les20
résultats. -
nextToken
— Un jeton de pagination renvoyé lors d'un précédent appel de cette opération. -
timeOrdering
— La commande à appliquer aux valeurs renvoyées :ASCENDING
ouDESCENDING
. -
qualities
— La qualité permettant de filtrer les résultats par :GOOD
BAD
, ouUNCERTAIN
.
Note
L'GetAssetPropertyAggregatesopération renvoie un TQV avec un format différent de celui des autres opérations décrites dans cette section. La structure value
contient un champ pour chacun des éléments aggregateTypes
de la demande. Le timestamp
contient l'heure à laquelle l'agrégation s'est produite, en secondes (heure UNIX Epoch).
Agrégats pour une propriété d'actif ()AWS CLI
Pour interroger des agrégats pour une propriété d'actif ()AWS CLI
-
Exécutez la commande suivante pour obtenir des agrégats pour la propriété de ressource. Cette commande interroge la moyenne et la somme avec une résolution d’1 heure pour un intervalle spécifique d’1 heure. Remplacez
asset-id
avec l'identifiant de l'actif etproperty-id
avec l'identifiant de la propriété. Remplacez les paramètres par les agrégats et l'intervalle à interroger.aws iotsitewise get-asset-property-aggregates \ --asset-id
asset-id
\ --property-idproperty-id
\ --start-date1575216000
\ --end-date1575219600
\ --aggregate-typesAVERAGE SUM
\ --resolution1h
L'opération renvoie une réponse contenant l'historique TQVs de la propriété au format suivant. La réponse inclut uniquement les agrégats demandés.
{ "aggregatedValues": [ { "timestamp":
Number
, "quality": "String
", "value": { "average":Number
, "count":Number
, "maximum":Number
, "minimum":Number
, "standardDeviation":Number
, "sum":Number
} } ], "nextToken": "String
" } -
S'il existe d'autres entrées de valeur, vous pouvez transmettre le jeton de pagination du
nextToken
champ à un appel ultérieur à l'GetAssetPropertyAggregatesopération.