구문
인수
db_name- TimeSeries 테이블이 있는 데이터베이스 이름입니다.time_series_table- TimeSeries 테이블 이름입니다.promql_query- PromQL 구문으로 작성한 쿼리입니다.evaluation_time - 평가 시각의 타임스탬프입니다. 현재 시각을 기준으로 쿼리를 평가하려면evaluation_time에now()`를 사용합니다.
반환 값
함수는promql_query 매개변수에 전달된 쿼리의 결과 유형에 따라 반환하는 컬럼이 달라질 수 있습니다:
TimeSeries 테이블의 version이 2 이하인 경우 samples 컬럼의 이름은 time_series가 됩니다.
지원되는 PromQL 기능
셀렉터
인스턴트 셀렉터, 범위 셀렉터, 레이블 매처(=, !=, =~, !~), offset 수정자, @ 타임스탬프 수정자, 서브쿼리.
함수
참고:
histogram_quantile은 클래식 히스토그램 버킷(le 레이블로 식별됨)에 선형 보간을 사용합니다. 네이티브 히스토그램은 지원되지 않습니다. phi(분위수 수준) 인수는 상수 스칼라여야 합니다. histogram_quantile(time() / 1000, ...)처럼 각 간격마다 달라지는 표현식은 NOT_IMPLEMENTED 예외와 함께 거부됩니다.
참고: ts_of_min_over_time 및 ts_of_max_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() 수정자와 함께 사용할 수 있습니다.
아직 지원되지 않는 기능
- 범위 함수
stddev_over_time,stdvar_over_time,mad_over_time,first_over_time,ts_of_last_over_time,ts_of_first_over_time