timeSeriesSelector - ClickHouse Documentation

Lit des séries temporelles d’une table TimeSeries, filtrées par un sélecteur et dont les horodatages appartiennent à un intervalle spécifié. Cette fonction est similaire aux sélecteurs de plage, mais elle sert aussi à implémenter des sélecteurs instantanés.

Syntaxe

timeSeriesSelector('db_name', 'time_series_table', 'instant_query', min_time, max_time)
timeSeriesSelector(db_name.time_series_table, 'instant_query', min_time, max_time)
timeSeriesSelector('time_series_table', 'instant_query', min_time, max_time)

Arguments

db_name - Nom de la base de données dans laquelle se trouve une table TimeSeries.
time_series_table - Nom d’une table TimeSeries.
instant_query - Un sélecteur instantané écrit en syntaxe PromQL, sans les modificateurs @ ni offset.
min_time - Horodatage de début, inclus.
max_time - Horodatage de fin, inclus.

min_time et max_time peuvent comporter des fractions de seconde, même si les timestamps de la table sont exprimés en secondes entières : la fonction sélectionne exactement les échantillons pour lesquels min_time <= timestamp <= max_time, sans arrondir les bornes en fonction du type des timestamps.

Valeur renvoyée

La fonction renvoie trois colonnes :

id - Contient les identifiants des séries temporelles correspondant au sélecteur spécifié.
timestamp - Contient les horodatages.
value - Contient les valeurs.

Aucun ordre particulier n’est garanti pour les données renvoyées.

Exemple

SELECT * FROM timeSeriesSelector(mytable, 'http_requests{job="prometheus"}', now() - INTERVAL 10 MINUTES, now())