Sintaxe
Argumentos
db_name- O nome do banco de dados em que uma tabela TimeSeries está localizada.time_series_table- O nome de uma tabela TimeSeries.promql_query- Uma consulta escrita em sintaxe PromQL.start_time- O horário de início do intervalo de avaliação.end_time- O horário de término do intervalo de avaliação.step- O passo usado para percorrer o tempo de avaliação destart_timeatéend_time(inclusive).
Valor retornado
A função pode retornar colunas diferentes, dependendo do tipo de resultado da consulta passada no parâmetropromql_query:
A coluna
samples é chamada de time_series se a tabela TimeSeries tiver a versão 2 ou anterior.
Funcionalidades do PromQL compatíveis
Seletores
Seletores instantâneos, seletores de intervalo, correspondências de labels (=, !=, =~, !~), modificadores de offset, modificadores @ de timestamp e subconsultas.
Funções
Nota:
histogram_quantile usa interpolação linear em buckets de histogramas clássicos (identificados pelo label le). Histogramas nativos não têm suporte. O argumento phi (nível do quantil) precisa ser um escalar constante. Expressões que variam a cada passo, como histogram_quantile(time() / 1000, ...), são rejeitadas com uma exceção NOT_IMPLEMENTED.
Nota: ts_of_min_over_time e ts_of_max_over_time são funções experimentais no Prometheus (habilitadas lá com --enable-feature=promql-experimental-functions); o ClickHouse as avalia sem exigir esse flag.
Operadores
Operadores binários aritméticos (+, -, *, /, %, ^, atan2) e de comparação (==, !=, <, >, <=, >= com o modificador opcional bool), com os modificadores on()/ignoring() e group_left()/group_right().
Operadores de conjunto lógicos and, or e unless, com os modificadores on()/ignoring().
Operadores unários + e -.
Operadores de agregação
sum, avg, min, max, count, count_values, stddev, stdvar, group, quantile, topk, bottomk, limitk — com os modificadores opcionais by() ou without().
Ainda não compatível
- Funções de intervalo
stddev_over_time,stdvar_over_time,mad_over_time,first_over_time,ts_of_last_over_time,ts_of_first_over_time