prometheusQueryRange - ClickHouse Documentation

Вычисляет запрос Prometheus, используя данные из таблицы TimeSeries в заданном диапазоне моментов вычисления.

Синтаксис

prometheusQueryRange('db_name', 'time_series_table', 'promql_query', start_time, end_time, step)
prometheusQueryRange(db_name.time_series_table, 'promql_query', start_time, end_time, step)
prometheusQueryRange('time_series_table', 'promql_query', start_time, end_time, step)

Аргументы

db_name - Имя базы данных, в которой находится таблица TimeSeries.
time_series_table - Имя таблицы TimeSeries.
promql_query - Запрос, записанный в синтаксисе PromQL.
start_time - Время начала интервала вычисления.
end_time - Время окончания интервала вычисления.
step - Шаг, с которым перебирается время вычисления от start_time до end_time (включительно).

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

Функция может возвращать разные столбцы в зависимости от типа результата запроса, переданного в параметр promql_query:

Тип результата	Возвращаемые столбцы	Пример
vector	tags Array(Tuple(String, String)), timestamp TimestampType, value ValueType	prometheusQuery(mytable, ‘up’)
matrix	tags Array(Tuple(String, String)), time_series Array(Tuple(TimestampType, ValueType))	prometheusQuery(mytable, ‘up[1m]‘)
scalar	scalar ValueType	prometheusQuery(mytable, ‘1h30m’)
string	string String	prometheusQuery(mytable, ‘“abc”‘)

Пример

SELECT * FROM prometheusQueryRange(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now() - INTERVAL 10 MINUTES, now(), INTERVAL 1 MINUTE)

Последнее изменение 12 июня 2026 г.