|
<< 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.
SELECT Name, Timestamp, Quality, Value FROM EpmQueryAggregateFunction(@timeZoneOffset, @startTime, @endTime, @sampleInterval, @aggregateFunction, @node)
•@timeZoneOffset: Fuso horário considerado. Os valores possíveis variam entre -12 e 14
•@startTime: Data inicial do período consultado. Deve ser utilizada uma String no formato yyyy-MM-dd HH:mm:ss
•@endTime: Data final do período consultado. Deve ser utilizada uma String no formato yyyy-MM-dd HH:mm:ss
•@sampleInterval: Intervalo de tempo utilizado para calcular a agregação, em milissegundos
•@aggregateFunction: Nome da função de agregação utilizada. Os valores possíveis para este parâmetro estão descritos na tabela a seguir
•@node: Variável ou variáveis 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 |
Retorna o número total de Anotações no intervalo de amostragem definido no parâmetro @sampleInterval |
Average |
Calcula a média aritmética dos valores brutos armazenados que possuem qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval |
Count |
Retorna o número total de valores brutos com qualidade boa armazenados no intervalo de amostragem definido no parâmetro @sampleInterval |
Delta |
Retorna a diferença entre o primeiro e o último valor bruto no intervalo de amostragem definido no parâmetro @sampleInterval e que tenham qualidade boa. Corresponde ao resultado do cálculo @endTime – @startTime |
DeltaBounds |
Retorna a diferença entre o valor com qualidade boa do início e do término do intervalo de amostragem definido no parâmetro @sampleInterval. Corresponde ao resultado do cálculo EndBounds – StartBounds |
DurationBad |
Retorna o tempo, em milissegundos, em que os dados estavam com qualidade ruim no intervalo de amostragem definido no parâmetro @sampleInterval. A qualidade é definida a partir da qualidade dos dados do limite deste intervalo |
DurationGood |
Retorna o tempo, em milissegundos, em que os dados estavam com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval. A qualidade é definida a partir da qualidade dos dados do limite deste intervalo |
DurationInStateNonZero |
Retorna o tempo transcorrido, em milissegundos, em que o estado de um valor com qualidade boa era diferente de 0 (zero) no intervalo de amostragem definido no parâmetro @sampleInterval |
DurationInStateZero |
Retorna o tempo transcorrido, em milissegundos, em que o estado de um valor com qualidade boa era 0 (zero) no intervalo de amostragem definido no parâmetro @sampleInterval |
End |
Retorna o último valor bruto com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval com a estampa de tempo em que este valor ocorreu |
EndBounds |
Retorna o valor com qualidade boa do término do intervalo de amostragem definido no parâmetro @sampleInterval |
Interpolative |
Interpola os pontos consecutivos dos dados com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval. Para variáveis discretas, a interpolação apenas mantém o valor anterior até o valor seguinte, enquanto para variáveis contínuas a interpolação entre dois pontos consecutivos é linear |
Maximum |
Equivale ao valor MaximumActualTime, porém utiliza a estampa de tempo do início do intervalo de amostragem definido no parâmetro @sampleInterval ao invés de quando o valor efetivamente ocorreu |
Maximum2 |
Equivale ao valor MaximumActualTime2, porém utiliza a estampa de tempo do início do intervalo de amostragem definido no parâmetro @sampleInterval ao invés de quando o valor efetivamente ocorreu |
MaximumActualTime |
Retorna o maior valor bruto com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval, utilizando a própria estampa de tempo de quando o valor ocorreu |
MaximumActualTime2 |
Retorna o maior valor de acordo com os dados interpolados linearmente no intervalo de amostragem definido no parâmetro @sampleInterval |
Minimum |
Equivale ao valor MinimumActualTime, porém utiliza a estampa de tempo do início do intervalo de amostragem definido no parâmetro @sampleInterval ao invés de quando o valor efetivamente ocorreu |
Minimum2 |
Equivale ao valor MinimumActualTime2, porém utiliza a estampa de tempo do início do intervalo de amostragem definido no parâmetro @sampleInterval ao invés de quando o valor efetivamente ocorreu |
MinimumActualTime |
Retorna o menor valor bruto com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval, utilizando a própria estampa de tempo de quando o valor ocorreu |
MinimumActualTime2 |
Retorna o menor valor de acordo com os dados interpolados linearmente no intervalo de amostragem definido no parâmetro @sampleInterval |
NumberOfTransitions |
Retorna o número total de transições de um valor bruto com qualidade boa de uma variável no intervalo de amostragem definido no parâmetro @sampleInterval |
PercentBad |
Retorna o resultado do cálculo (DurationBad ÷ @sampleInterval) × 100 |
PercentGood |
Retorna o resultado do cálculo (DurationGood ÷ @sampleInterval) × 100 |
PercentInStateNonZero |
Retorna o resultado do cálculo (DurationInStateNonZero ÷ @sampleInterval) × 100 |
PercentInStateZero |
Retorna o resultado do cálculo (DurationInStateZero ÷ @sampleInterval) × 100 |
Range |
Retorna a diferença entre o valor bruto máximo e mínimo com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval. Se houver apenas um valor com qualidade boa neste intervalo, retorna o valor 0 (zero) |
Range2 |
Retorna a diferença entre o maior valor e o menor valor de acordo com os dados interpolados linearmente no intervalo de amostragem definido no parâmetro @sampleInterval |
StandardDeviationPopulation |
Retorna o desvio padrão populacional no intervalo de amostragem definido no parâmetro @sampleInterval |
StandardDeviationSample |
Retorna o desvio padrão amostral no intervalo de amostragem definido no parâmetro @sampleInterval |
Start |
Retorna o primeiro valor bruto com qualidade boa no intervalo de amostragem definido no parâmetro @sampleInterval com a estampa de tempo em que este valor ocorreu |
StartBounds |
Retorna o valor com qualidade boa do início do intervalo de amostragem definido no parâmetro @sampleInterval |
TimeAverage |
Calcula a média ponderada pelo tempo, utilizando os dados com qualidade boa interpolados linearmente no intervalo de amostragem definido no parâmetro @sampleInterval |
TimeAverage2 |
Calcula a média ponderada pelo tempo, utilizando os dados interpolados mantendo o valor anterior até o valor seguinte, no intervalo de amostragem definido no parâmetro @sampleInterval |
Total |
Retorna o resultado do cálculo TimeAverage × @sampleInterval, em segundos |
Total2 |
Retorna o resultado do cálculo TimeAverage2 × @sampleInterval, em segundos |
Trend |
Interpola automaticamente os dados no intervalo de amostragem definido no parâmetro @sampleInterval, priorizando a qualidade para visualização em um gráfico segundo uma dada resolução de tela |
VariancePopulation |
Retorna a variância populacional, ou seja, a raiz quadrada do desvio padrão populacional no intervalo de amostragem definido no parâmetro @sampleInterval |
VarianceSample |
Retorna a variância amostral, ou seja, a raiz quadrada do desvio padrão amostral no intervalo de amostragem definido no parâmetro @sampleInterval |
WorstQuality |
Retorna a pior qualidade dos dados brutos no intervalo de amostragem definido no parâmetro @sampleInterval. A qualidade Bad (Ruim) é pior que Uncertain (Incerta), que por sua vez é pior que Good (Boa). A estampa de tempo sempre corresponde ao início deste intervalo |
WorstQuality2 |
Retorna a pior qualidade dos dados brutos no intervalo de amostragem definido no parâmetro @sampleInterval. A qualidade Bad (Ruim) é pior que Uncertain (Incerta), que por sua vez é pior que Good (Boa). O início do intervalo sempre é incluído para determinar a pior qualidade. A estampa de tempo sempre corresponde ao início deste intervalo |
•Name: Nome da variável ou variáveis consultadas
•Timestamp: Estampa de tempo dos dados
•Quality: Qualidade dos dados
•Value: Valor dos dados
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')