Syntaxe
Arguments
db_name- Le nom de la base de données dans laquelle se trouve une table TimeSeries.time_series_table- Le nom d’une table TimeSeries.promql_query- Une requête écrite en syntaxe PromQL.evaluation_time - L’horodatage d’évaluation. Pour évaluer une requête à l’instant présent, utiliseznow()commeevaluation_time`.
Valeur renvoyée
La fonction peut renvoyer des colonnes différentes selon le type de résultat de la requête passée au paramètrepromql_query :
La colonne
samples est nommée time_series si la table TimeSeries est en version 2 ou antérieure.
Fonctionnalités PromQL prises en charge
Sélecteurs
Sélecteurs instantanés, sélecteurs d’intervalle, correspondances de labels (=, !=, =~, !~), modificateurs de décalage, modificateurs d’horodatage @ et sous-requêtes.
Fonctions
Remarque :
histogram_quantile utilise une interpolation linéaire sur les classes des histogrammes classiques (repérées par le label le). Les histogrammes natifs ne sont pas pris en charge. L’argument phi (niveau de quantile) doit être une constante scalaire. Les expressions qui varient d’un pas à l’autre, telles que histogram_quantile(time() / 1000, ...), sont rejetées avec une exception NOT_IMPLEMENTED.
Remarque : ts_of_min_over_time et ts_of_max_over_time sont des fonctions expérimentales dans Prometheus (où elles s’activent avec --enable-feature=promql-experimental-functions) ; ClickHouse les évalue sans exiger ce flag.
Opérateurs
Opérateurs binaires arithmétiques (+, -, *, /, %, ^, atan2) et de comparaison (==, !=, <, >, <=, >= avec bool facultatif), avec les modificateurs on()/ignoring() et group_left()/group_right().
Opérateurs d’ensemble logiques and, or et unless, avec les modificateurs on()/ignoring().
Opérateurs unaires + et -.
Opérateurs d’agrégation
sum, avg, min, max, count, count_values, stddev, stdvar, group, quantile, topk, bottomk, limitk — avec les modificateurs facultatifs by() ou without().
Pas encore pris en charge
- Fonctions de plage
stddev_over_time,stdvar_over_time,mad_over_time,first_over_time,ts_of_last_over_time,ts_of_first_over_time