Funções de agregação

Somente em métricas, você pode usar as seguintes funções que agregam valores de entrada em 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, números literais, funções temporais, expressões aninhadas ou funções de agregação. A fórmulamax(latest(x), latest(y), latest(z)) usa uma função de agregação como argumento e retorna o maior valor atual dasz propriedadesxy, e.

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

• Cada argumento pode ter apenas um conjunto de variáveis.

  Por exemplo,avg(x*(x-1)) esum(x/2 )/avg(y^2 ) são suportados.

  Por exemplo,min(x/y) não é compatível.

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

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

• Argumentos diferentes podem ter variáveis diferentes.

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

nota

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

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

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 correspondem 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 fornecidas no 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.