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())