prometheusQueryRange

평가 시간 범위 전반에 걸쳐 TimeSeries 테이블의 데이터를 사용해 Prometheus 쿼리를 평가합니다.

구문

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”‘)

지원되는 PromQL 기능

셀렉터

인스턴트 셀렉터, 범위 셀렉터, 레이블 매처(=, !=, =~, !~), offset 수정자, @ 타임스탬프 수정자, 그리고 서브쿼리.

함수

범주	함수
범위	`rate`, `irate`, `delta`, `idelta`, `increase`, `last_over_time`, `deriv`, `changes`, `resets`
수학	`abs`, `sgn`, `floor`, `ceil`, `sqrt`, `exp`, `ln`, `log2`, `log10`, `rad`, `deg`, `round`, `clamp`, `clamp_min`, `clamp_max`
삼각함수	`sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `sinh`, `cosh`, `tanh`, `asinh`, `acosh`, `atanh`
DateTime	`day_of_week`, `day_of_month`, `days_in_month`, `day_of_year`, `minute`, `hour`, `month`, `year`
레이블	`label_replace`, `label_join`
유형	`scalar`, `vector`
히스토그램	`histogram_quantile`
기타	`time`, `pi`

참고: histogram_quantile은 기존 히스토그램 버킷(le 레이블로 식별됨)에 선형 보간을 사용합니다. 네이티브 히스토그램은 지원되지 않습니다. phi(분위수 수준) 인수는 상수 스칼라여야 합니다. histogram_quantile(time() / 1000, ...)처럼 간격마다 값이 달라지는 표현식은 NOT_IMPLEMENTED 예외와 함께 거부됩니다.

연산자

on()/ignoring() 및 group_left()/group_right() 수정자와 함께 사용하는 모든 산술(+, -, *, /, %, ^, atan2), 비교(==, !=, <, >, <=, >=, 선택적 bool 포함) 이항 연산자 on()/ignoring() 수정자와 함께 사용하는 논리 집합 연산자 and, or, unless 단항 연산자 + 및 -.

집계 연산자

sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk — 선택적으로 by() 또는 without() 수정자와 함께 사용할 수 있습니다.

아직 지원되지 않는 기능

집계 연산자 count_values
범위 함수 predict_linear, avg_over_time, min_over_time, max_over_time, sum_over_time, count_over_time, quantile_over_time, stddev_over_time, stdvar_over_time, present_over_time, absent_over_time, mad_over_time, first_over_time, ts_of_min_over_time, ts_of_max_over_time, ts_of_last_over_time, ts_of_first_over_time
함수 absent

예시

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

SQL 참고

데이터 타입

엔진

함수

포맷

인터페이스

설정

시스템 테이블

데이터 레이크

구문

인수

반환 값

지원되는 PromQL 기능

셀렉터

함수

연산자

집계 연산자

아직 지원되지 않는 기능

예시

​구문

​인수

​반환 값

​지원되는 PromQL 기능

​셀렉터

​함수

​연산자

​집계 연산자

​아직 지원되지 않는 기능

​예시

구문

인수

반환 값

지원되는 PromQL 기능

셀렉터

함수

연산자

집계 연산자

아직 지원되지 않는 기능

예시