Skip to main content

​
timeSeriesDerivToGrid

Introduzido em: v25.6.0 Função de agregação que recebe dados de séries temporais como pares de timestamps e valores e calcula a derivada no estilo do PromQL a partir desses dados em uma grade temporal regular definida pelo timestamp inicial, timestamp final e passo. Para cada ponto da grade, as amostras para calcular deriv são consideradas dentro da janela de tempo especificada. As amostras podem ser passadas em uma de três formas:
  • como dois argumentos timestamp e value, em que cada linha contém uma única amostra;
  • como dois arrays de timestamps e valores, em que cada linha contém uma série temporal inteira;
  • como um único array de tuplas (timestamp, value), em que cada linha contém uma série temporal inteira.
Se várias amostras tiverem o mesmo timestamp, apenas uma delas será usada: a amostra com o maior valor. Um valor NaN perde para qualquer outro valor; portanto, um valor NaN só será usado se todas as amostras nesse timestamp forem NaN.
Esta função está em private preview; habilite-a definindo enable_time_series_aggregate_functions=true.
Sintaxe
Parâmetros
  • start_timestamp — Especifica o início da grade. Também pode ser um número fracionário ou uma string que contenha um número ou um texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • end_timestamp — Especifica o fim da grade. Também pode ser um número fracionário ou uma string que contenha um número ou um texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • grid_step — Especifica o passo da grade em segundos. Também pode ser um número fracionário ou uma string que contenha um número ou uma duração como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
  • staleness — Especifica a “staleness” máxima, em segundos, das amostras consideradas. A janela de staleness é um intervalo aberto à esquerda e fechado à direita. Também pode ser um número fracionário ou uma string que contenha um número ou uma duração como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
Argumentos
  • timestamp — Timestamp da amostra. Pode ser um valor individual ou arrays. UInt32 ou DateTime ou DateTime64 ou Array(UInt32) ou Array(DateTime) ou Array(DateTime64)
  • value — Valor da série temporal correspondente ao timestamp. Pode ser um valor individual ou arrays. Float* ou Array(Float*)
  • samples — Amostras da série temporal passadas como um array de tuplas (timestamp, value), em que os elementos da tupla têm os tipos de timestamp e valor listados acima. Uma alternativa a passar os timestamps e os valores como dois argumentos separados. Array(Tuple(T1, T2))
Valor retornado Valores de deriv na grade especificada como um Array(Nullable(Float64)). O array retornado contém um valor para cada ponto da grade temporal. O valor é NULL se não houver amostras suficientes dentro da janela para calcular o valor da derivada para um determinado ponto da grade. Exemplos Calcular valores da derivada na grade [90, 105, 120, 135, 150, 165, 180, 195, 210]
Query
Response
Mesma consulta com argumentos de array
Query
Response