구문
인수
db_name- TimeSeries 테이블이 있는 데이터베이스 이름입니다.time_series_table- TimeSeries 테이블 이름입니다.promql_query- PromQL 구문으로 작성한 쿼리입니다.evaluation_time- 밀리초 또는 그보다 높은 정밀도의 평가 시각 타임스탬프입니다. 현재 시각을 기준으로 쿼리를 평가하려면evaluation_time에now()를 사용합니다.
반환 값
함수는promql_query 매개변수에 전달된 쿼리의 결과 유형에 따라 반환하는 컬럼이 달라집니다:
값은 TimeSeries 테이블에 저장된 값의 유형과 관계없이 항상
Float64입니다. 타임스탬프의 정밀도 S는 테이블에 저장된
타임스탬프의 정밀도와 같지만 최소 3(밀리초)입니다. evaluation_time이 시간대가 지정된 DateTime 또는
DateTime64 유형이면 시간대 TZ는 해당 시간대이며, 그렇지 않으면 테이블에 저장된 타임스탬프의 시간대입니다.
TimeSeries 테이블의 version이 2 이하인 경우 samples 컬럼의 이름은 time_series가 됩니다.
지원되는 PromQL 기능
셀렉터
인스턴트 셀렉터, 범위 셀렉터, 레이블 매처(=, !=, =~, !~), offset 수정자, @ 타임스탬프 수정자, 서브쿼리.
함수
참고:
histogram_quantile은 클래식 히스토그램 버킷(le 레이블로 식별됨)에 선형 보간을 사용합니다. 네이티브 히스토그램은 지원되지 않습니다. phi(분위수 수준) 인수는 상수 스칼라여야 합니다. histogram_quantile(time() / 1000, ...)처럼 각 간격마다 달라지는 표현식은 NOT_IMPLEMENTED 예외와 함께 거부됩니다.
참고: min_of(a, b)와 max_of(a, b)는 두 스칼라 값 중 각각 더 작은 값과 더 큰 값을 반환합니다. 두 인수 모두 스칼라여야 합니다.
참고: min_of, max_of, ts_of_min_over_time, ts_of_max_over_time, ts_of_last_over_time, first_over_time, ts_of_first_over_time 및 mad_over_time은 Prometheus의 실험적 함수입니다(Prometheus에서는 --enable-feature=promql-experimental-functions 플래그로 활성화됨). ClickHouse는 이 플래그 없이도 이를 평가합니다.
연산자
on()/ignoring() 및 group_left()/group_right() 수정자와 함께 사용하는 산술(+, -, *, /, %, ^, atan2) 및 비교(==, !=, <, >, <=, >=, 선택적 bool 포함) 이항 연산자입니다.
on()/ignoring() 수정자와 함께 사용하는 논리 집합 연산자 and, or, unless입니다.
단항 연산자 + 및 -.
집계 연산자
sum, avg, min, max, count, count_values, stddev, stdvar, group, quantile, topk, bottomk, limitk — 선택적으로 by() 또는 without() 수정자와 함께 사용할 수 있습니다.