timeSeriesSelector - ClickHouse Documentation

셀렉터로 필터링되고 타임스탬프가 지정된 인터벌 내에 있는 TimeSeries 테이블에서 시계열을 읽어옵니다. 이 함수는 range selectors와 유사하지만, instant selectors를 구현하는 데에도 사용됩니다.

구문

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 - @ 또는 offset 수정자 없이 PromQL 구문으로 작성된 instant selector입니다.
min_time - 시작 타임스탬프이며, 해당 값도 포함됩니다.
max_time - 종료 타임스탬프이며, 해당 값도 포함됩니다.

테이블의 타임스탬프가 정수 초 단위이더라도 min_time과 max_time에는 소수 초를 지정할 수 있습니다. 이 함수는 경계를 타임스탬프 유형에 맞춰 반올림하지 않고, min_time <= timestamp <= max_time 조건을 정확히 만족하는 샘플을 선택합니다.

반환 값

이 함수는 3개의 컬럼을 반환합니다:

id - 지정된 셀렉터와 일치하는 시계열의 식별자를 포함합니다.
timestamp - 타임스탬프를 포함합니다.
value - 값을 포함합니다.

반환되는 데이터에는 정해진 순서가 없습니다.

예시

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