Utilice funciones de agregación en las expresiones de fórmulas - AWS IoT SiteWise

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice funciones de agregación en las expresiones de fórmulas

Solo en las métricas, puede utilizar las siguientes funciones que agregan valores de entrada en cada intervalo de tiempo y calculan un único valor de salida. Las funciones de agregación pueden agregar datos de activos asociados.

Los argumentos de las funciones de agregación pueden ser variables, literales numéricos, funciones temporales, expresiones anidadas o funciones de agregación. La fórmula max(latest(x), latest(y), latest(z)) utiliza una función de agregación como argumento y devuelve el valor actual más grande de las propiedades x, y y z.

Puede utilizar expresiones anidadas en las funciones de agregación. Cuando se utilizan expresiones anidadas, se aplican las reglas siguientes:

  • Cada argumento solo puede tener una variable.

    Por ejemplo, avg(x*(x-1)) y sum(x/2 )/avg(y^2 ) son compatibles.

    Por ejemplo, min(x/y) no es compatible.

  • Cada argumento puede tener expresiones anidadas de varios niveles.

    Por ejemplo, sum(avg(x^2 )/2) no se admite.

  • Cada argumento puede tener variables diferentes.

    Por ejemplo, sum(x/2, y*2) no se admite.

nota

  • Si las expresiones contienen medidas, AWS IoT SiteWise utiliza los últimos valores del intervalo de tiempo actual para que las mediciones calculen los agregados.

  • Si las expresiones contienen atributos, AWS IoT SiteWise utiliza los valores más recientes de los atributos para calcular los agregados.

Función Descripción

avg(x0, ..., xn)

Devuelve la media de los valores de las variables dadas durante el intervalo de tiempo actual.

Esta función genera un punto de datos solo si las variables dadas tienen al menos un punto de datos durante el intervalo de tiempo actual.

sum(x0, ..., xn)

Devuelve la suma de los valores de las variables dadas durante el intervalo de tiempo actual.

Esta función genera un punto de datos solo si las variables dadas tienen al menos un punto de datos durante el intervalo de tiempo actual.

min(x0, ..., xn)

Devuelve el mínimo de los valores de las variables dadas durante el intervalo de tiempo actual.

Esta función genera un punto de datos solo si las variables dadas tienen al menos un punto de datos durante el intervalo de tiempo actual.

max(x0, ..., xn)

Devuelve el máximo de los valores de las variables dadas durante el intervalo de tiempo actual.

Esta función genera un punto de datos solo si las variables dadas tienen al menos un punto de datos durante el intervalo de tiempo actual.

count(x0, ..., xn)

Devuelve el número total de puntos de datos para las variables dadas durante el intervalo de tiempo actual. Para obtener más información acerca de cómo contar el número de puntos de datos que cumplen una condición, consulte Cuente los puntos de datos que coincidan con una condición.

Esta función calcula un punto de datos para cada intervalo de tiempo.

stdev(x0, ..., xn)

Devuelve la desviación estándar de los valores de las variables dadas durante el intervalo de tiempo actual.

Esta función genera un punto de datos solo si las variables dadas tienen al menos un punto de datos durante el intervalo de tiempo actual.