Utilisation de fonctions d'agrégation dans des expressions de formule

Dans les métriques uniquement, vous pouvez utiliser les fonctions suivantes pour agréger les valeurs d'entrée sur chaque intervalle de temps et calculer une valeur de sortie unique. Les fonctions d'agrégation peuvent agréger les données issues de ressources associées.

Les arguments des fonctions d'agrégation peuvent être des variables, des littéraux numériques, des fonctions temporelles, des expressions imbriquées ou des fonctions d'agrégation. La formule max(latest(x), latest(y), latest(z)) utilise une fonction d'agrégation comme argument et renvoie la plus grande valeur actuelle des z propriétés xy, et.

Vous pouvez utiliser des expressions imbriquées dans les fonctions d'agrégation. Lorsque vous utilisez des expressions imbriquées, les règles suivantes s'appliquent :

• Chaque argument ne peut comporter qu'une seule variable.

  Par exemple, avg(x*(x-1)) et sum(x/2 )/avg(y^2 ) sont pris en charge.

  Par exemple, min(x/y) n'est pas pris en charge.

• Chaque argument peut comporter des expressions imbriquées à plusieurs niveaux.

  Par exemple, sum(avg(x^2 )/2) est pris en charge.

• Les différents arguments peuvent avoir des variables différentes.

  Par exemple, sum(x/2, y*2) est pris en charge.

Note

• Si vos expressions contiennent des mesures, AWS IoT SiteWise utilise les dernières valeurs de l'intervalle de temps actuel pour que les mesures calculent les agrégats.

• Si vos expressions contiennent des attributs, AWS IoT SiteWise utilise les dernières valeurs des attributs pour calculer les agrégats.

Fonction	Description
avg(x0, ..., xn)	Renvoie la moyenne des valeurs des variables données sur l'intervalle de temps actuel. Cette fonction produit un point de données uniquement si les variables données ont au moins un point de données sur l'intervalle de temps actuel.
sum(x0, ..., xn)	Renvoie la somme des valeurs de variables données sur l'intervalle de temps actuel. Cette fonction produit un point de données uniquement si les variables données ont au moins un point de données sur l'intervalle de temps actuel.
min(x0, ..., xn)	Renvoie la valeur minimale des valeurs des variables données sur l'intervalle de temps actuel. Cette fonction produit un point de données uniquement si les variables données ont au moins un point de données sur l'intervalle de temps actuel.
max(x0, ..., xn)	Renvoie la valeur maximale des valeurs de variables données sur l'intervalle de temps actuel. Cette fonction produit un point de données uniquement si les variables données ont au moins un point de données sur l'intervalle de temps actuel.
count(x0, ..., xn)	Renvoie le nombre total de points de données pour les variables données sur l'intervalle de temps actuel. Pour de plus amples informations sur la comptabilisation du nombre de points de données qui répondent à une condition, veuillez consulter Comptage des points de données correspondant à une condition. Cette fonction calcule un point de données pour chaque intervalle de temps.
stdev(x0, ..., xn)	Renvoie l'écart type des valeurs des variables données sur l'intervalle de temps actuel. Cette fonction produit un point de données uniquement si les variables données ont au moins un point de données sur l'intervalle de temps actuel.