Usando funções de agregação em expressões de fórmulas - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando funções de agregação em expressões de fórmulas

Somente em métricas, você pode usar as seguintes funções que agregam valores de entrada a cada intervalo de tempo e calculam um único valor de saída: Algumas funções de agregação não podem agregar dados de ativos associados.

Os argumentos da função de agregação podem ser variáveis, literais numéricos, funções temporais, expressões aninhadas ou funções de agregação. A fórmula max(latest(x), latest(y), latest(z)) usa uma função de agregação como argumento e retorna o maior valor atual das propriedades x, y e z.

Você pode usar expressões aninhadas em funções de agregação. Ao usar expressões aninhadas, as seguintes regras se aplicam:

  • Cada argumento pode ter apenas uma variável.

    Por exemplo, avg(x*(x-1)) e sum(x/2 )/avg(y^2 ) são suportadas.

    Por exemplo, min(x/y) não é suportada.

  • Cada argumento pode ter expressões aninhadas de vários níveis.

    Por exemplo, sum(avg(x^2 )/2) é suportada.

  • Argumentos diferentes podem ter variáveis diferentes.

    Por exemplo, sum(x/2, y*2) é suportada.

nota
  • Se suas expressões contiverem medidas, AWS IoT SiteWise use os últimos valores no intervalo de tempo atual para que as medidas calculem agregados.

  • Se suas expressões contiverem atributos, AWS IoT SiteWise use os valores mais recentes dos atributos para calcular agregados.

Função Descrição

avg(x0, ..., xn)

Retorna a média dos valores das variáveis fornecidas ao longo do intervalo de tempo atual.

Essa função gera um ponto de dados somente se as variáveis fornecidas tiverem pelo menos um ponto de dados no intervalo de tempo atual.

sum(x0, ..., xn)

Retorna a soma dos valores das variáveis fornecidas ao longo do intervalo de tempo atual.

Essa função gera um ponto de dados somente se as variáveis fornecidas tiverem pelo menos um ponto de dados no intervalo de tempo atual.

min(x0, ..., xn)

Retorna o valor mínimo dos valores das variáveis fornecidas ao longo do intervalo de tempo atual.

Essa função gera um ponto de dados somente se as variáveis fornecidas tiverem pelo menos um ponto de dados no intervalo de tempo atual.

max(x0, ..., xn)

Retorna o valor máximo das variáveis fornecidas ao longo do intervalo de tempo atual.

Essa função gera um ponto de dados somente se as variáveis fornecidas tiverem pelo menos um ponto de dados no intervalo de tempo atual.

count(x0, ..., xn)

Retorna o número total de pontos de dados das variáveis fornecidas ao longo do intervalo de tempo atual. Para obter mais informações sobre como contar o número de pontos de dados que atendem a uma condição, consulte Contando pontos de dados que correspondam a uma condição.

Esta função calcula um ponto de dados para cada intervalo de tempo.

stdev(x0, ..., xn)

Retorna o desvio padrão dos valores das variáveis fornecidos ao longo do intervalo de tempo atual.

Essa função gera um ponto de dados somente se as variáveis fornecidas tiverem pelo menos um ponto de dados no intervalo de tempo atual.