Syntaxe
Arguments
db_name- Le nom de la base de données où se trouve une table TimeSeries.time_series_table- Le nom d’une table TimeSeries.promql_query- Une requête écrite en syntaxe PromQL.start_time- L’heure de début de la plage d’évaluation.end_time- L’heure de fin de la plage d’évaluation.step- Le pas utilisé pour faire progresser le temps d’évaluation destart_timeàend_time(bornes incluses).
Valeur renvoyée
La fonction peut renvoyer différentes colonnes selon le type de résultat de la requête transmise 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 de plage, correspondances de labels (=, !=, =~, !~), modificateurs offset, modificateurs d’horodatage @ et sous-requêtes.
Fonctions
Remarque :
histogram_quantile utilise une interpolation linéaire sur les buckets d’histogrammes classiques (identifiés par le label le). Les histogrammes natifs ne sont pas pris en charge. L’argument phi (niveau de quantile) doit être un scalaire constant. Les expressions qui varient à chaque pas, comme 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 (activées 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 en option), avec les modificateurs on()/ignoring() et group_left()/group_right().
Opérateurs d’ensemble logiques and, or et unless, avec les modificateurs on()/ignoring().
Les 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