timeSeriesSelector - ClickHouse Documentation

Читает временные ряды из таблицы TimeSeries, отфильтрованные селектором, с временными метками в заданном интервале. Эта функция похожа на диапазонные селекторы, но также используется для реализации мгновенных селекторов.

Синтаксис

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)

Аргументы

db_name - Имя базы данных, в которой находится таблица TimeSeries.
time_series_table - Имя таблицы TimeSeries.
instant_query - Мгновенный селектор, записанный с использованием синтаксиса PromQL, без модификаторов @ или offset.
min_time - Начальная временная метка, включительно.
max_time - Конечная временная метка, включительно.

min_time и max_time могут задаваться с долями секунды, даже если временные метки в таблице имеют точность до целой секунды: функция выбирает отсчёты, строго соответствующие условию min_time <= timestamp <= max_time, не округляя границы в соответствии с типом временных меток.

Возвращаемое значение

Функция возвращает три столбца:

id — содержит идентификаторы временных рядов, соответствующих указанному селектору.
timestamp — содержит временные метки.
value — содержит значения.

Для возвращаемых данных определённый порядок не гарантируется.

Пример

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