EpmQueryAggregateFunction

<< Clique para Mostrar o Sumário >>

 

EpmQueryAggregateFunction

Retorna os dados de uma ou mais variáveis, separadas por vírgula, informadas no parâmetro @node, de acordo com o formato definido pela função de agregação indicada pelo parâmetro @aggregateFunction.

 

Sintaxe

SELECT Name, Timestamp, Quality, Value FROM EpmQueryAggregateFunction(@timeZoneOffset, @startTime, @endTime, @sampleInterval, @aggregateFunction, @node)

 

Parâmetros

@timeZoneOffset: Fuso horário a ser considerado. Os valores possíveis variam entre -12 e 14

@startTime: Data inicial do período a ser consultado. Deve ser utilizada uma String no formato yyyy-MM-dd HH:mm:ss

@endTime: Data final do período a ser consultado. Deve ser utilizada uma String no formato yyyy-MM-dd HH:mm:ss

@sampleInterval: Intervalo de tempo a ser utilizado para calcular a agregação, em milissegundos

@aggregateFunction: Nome da função de agregação a ser utilizada. Os valores possíveis para este parâmetro estão descritos na tabela a seguir

@node: Variável ou variáveis a serem consultadas. Deve ser informado o nome ou os nomes completos entre aspas simples e separados por vírgula

 

Valores possíveis para o parâmetro @aggregateFunction

Valor

Descrição

AnnotationCount

Informa quantas anotações a variável possui dentro do intervalo de amostragem

Average

Calcula a média aritmética dos valores dos dados com qualidade boa dentro do intervalo de amostragem definido no parâmetro @sampleInterval

Count

Retorna a quantidade de dados presentes no intervalo de amostragem definido no parâmetro @sampleInterval

Delta

Retorna a diferença entre o primeiro e o último valores de qualidade boa dentro de cada intervalo de amostragem

DeltaBounds

Retorna a diferença entre o primeiro e o último valores de qualidade boa dentro de cada intervalo de amostragem. Leva em conta os Simple Bounding Values

DurationBad

Retorna o tempo, em milissegundos, em que os dados estavam com qualidade ruim dentro do intervalo de amostragem. A qualidade é definida a partir da qualidade dos dados dos extremos do intervalo

DurationGood

Retorna o tempo, em milissegundos, em que os dados estavam com qualidade boa dentro do intervalo de amostragem. A qualidade é definida a partir da qualidade dos dados dos extremos do intervalo

DurationInStateNonZero

Retorna o tempo total, em milissegundos, em que o valor se manteve diferente de 0 (zero) dentro do intervalo de amostragem

DurationInStateZero

Retorna o tempo total, em milissegundos, em que o valor se manteve em 0 (zero) dentro do intervalo de amostragem

End

Equivale à função Interpolative, porém utiliza a estampa de tempo original do último valor do intervalo de amostragem

EndBounds

Equivale à função Interpolative, porém utiliza a estampa de tempo original do último valor do intervalo de amostragem. Leva em conta os Simple Bounding Values

Interpolative

Interpola os dados do intervalo consultado, retornando pontos conforme o intervalo definido no parâmetro @sampleInterval

Maximum

Informa o maior valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval. A estampa de tempo corresponde ao horário do início de cada intervalo de amostragem

Maximum2

Informa o maior valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval. A estampa de tempo corresponde ao horário do início de cada intervalo de amostragem. Leva em conta os Simple Bounding Values

MaximumActualTime

Informa o maior valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval, com a diferença de que a estampa de tempo apresentada corresponde ao momento de ocorrência do maior valor encontrado

MaximumActualTime2

Informa o maior valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval, com a diferença de que a estampa de tempo apresentada corresponde ao momento de ocorrência do maior valor encontrado. Leva em conta os Simple Bounding Values

Minimum

Informa o menor valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval. A estampa de tempo corresponde ao horário do início de cada intervalo de amostragem

Minimum2

Informa o menor valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval. A estampa de tempo corresponde ao horário do início de cada intervalo de amostragem. Leva em conta os Simple Bounding Values

MinimumActualTime

Informa o menor valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval, com a diferença de que a estampa de tempo apresentada corresponde ao momento de ocorrência do menor valor encontrado

MinimumActualTime2

Informa o menor valor encontrado nos dados dentro do intervalo de amostragem definido no parâmetro @sampleInterval, com a diferença de que a estampa de tempo apresentada corresponde ao momento de ocorrência do menor valor encontrado. Leva em conta os Simple Bounding Values

NumberOfTransitions

Informa quantas transições ocorreram dentro do intervalo de amostragem entre os valores 0 (zero) e 1 (um)

PercentBad

Retorna a porcentagem do tempo, em relação ao tempo do intervalo de amostragem, em que os dados estavam com qualidade ruim

PercentGood

Retorna a porcentagem do tempo, em relação ao tempo do intervalo de amostragem, em que os dados estavam com qualidade boa

PercentInStateNonZero

Retorna a porcentagem do tempo, em relação ao tempo total do intervalo de amostragem, em que o valor se manteve diferente de 0 (zero)

PercentInStateZero

Retorna a porcentagem do tempo, em relação ao tempo total do intervalo de amostragem, em que o valor se manteve em 0 (zero)

Range

Retorna a diferença entre o menor e o maior valor encontrado dentro do intervalo de amostragem informado no parâmetro @sampleInterval. Ignora valores de qualidade ruim

Range2

Retorna a diferença entre o menor e o maior valor encontrado dentro do intervalo de amostragem informado no parâmetro @sampleInterval. Ignora valores de qualidade ruim e leva em conta os Simple Bounding Values

StandardDeviationPopulation

Retorna o desvio padrão populacional (n) no intervalo solicitado. Inclui os Simple Bounding Values

StandardDeviationSample

Retorna o desvio padrão amostral (n - 1) no intervalo solicitado

Start

Equivale à função Interpolative, porém utiliza a estampa de tempo original do primeiro valor do intervalo de amostragem

StartBounds

Equivale à função Interpolative, porém utiliza a estampa de tempo original do primeiro valor do intervalo de amostragem. Leva em conta os Simple Bounding Values

TimeAverage

Calcula a média ponderada pelo tempo utilizando o método Interpolated Bounding Values dentro do intervalo de amostragem definido no parâmetro @sampleInterval

TimeAverage2

Calcula a média ponderada pelo tempo utilizando o método Simple Bounding Values dentro do intervalo de amostragem definido no parâmetro @sampleInterval

Total

Retorna a totalização dos dados do intervalo de amostragem definido no parâmetro @sampleInterval

Total2

Retorna a totalização dos dados com qualidade boa do intervalo de amostragem definido no parâmetro @sampleInterval

Trend

Interpola os dados consultados de forma a serem melhor visualizados em gráficos

VariancePopulation

Retorna a variância para a função StandardDeviationPopulation

VarianceSample

Retorna a variância para a função StandardDeviationSample

WorstQuality

Retorna a pior qualidade encontrada no intervalo especificado no parâmetro @sampleInterval

WorstQuality2

Retorna a pior qualidade encontrada no intervalo especificado no parâmetro @sampleInterval. Leva em conta os Simple Bounding Values

 

Campos do Resultado

Name: Nome da variável ou variáveis consultadas

Timestamp: Estampa de tempo dos dados

Quality: Qualidade dos dados

Value: Valor dos dados

 

Exemplo de Uso

Para retornar os dados da variável RandomTags_Random1 no período entre 10:23 e 11:23 do dia 07/12/2020, com um fuso horário de -3 (menos três) horas e interpolados a cada 5 (cinco) minutos, use a declaração a seguir.

SELECT Name, Timestamp, Quality, Value FROM EpmQueryAggregateFunction(-3, '2020-12-07 10:23:00', '2020-12-07 11:23:00', 300000, 'Interpolative', 'RandomTags1')

Esta página foi útil?