다음을 통해 공유


kll_sketch_get_quantile_float 함수

적용 대상:선택됨 Databricks Runtime 18.0 이상

부동 KLL 스케치에서 지정된 분위수 순위(또는 여러 순위)의 값을 추정합니다.

문법

kll_sketch_get_quantile_float ( sketch, rank )

Arguments

  • sketch BINARY: 직렬화된 FLOAT KLL 스케치를 포함하는 식입니다.
  • rank: DOUBLE 표현식 또는 ARRAY<DOUBLE> 분위수의 순위가 0.0에서 1.0 사이인 경우, 다음이 적용됩니다.
    • 0.0은 최소값입니다.
    • 0.5는 중앙값이고,
    • 1.0은 최대값입니다.

반품

  • rank이 DOUBLE면 예상 분위수 값을 반환 FLOAT 합니다.
  • rank이 ARRAY<DOUBLE> 경우: 각 순위에 대한 분위수를 추정하여 ARRAY<FLOAT>을 반환합니다.

비고

  • 순위는 0.0에서 1.0 사이여야 합니다.
  • 스케치가 비어 있으면 반환 NULL 합니다.
  • 일반적인 분위수: 0.25(Q1), 0.5(중앙값), 0.75(Q3), 0.95(P95), 0.99(P99).

예시

> WITH sketch_data AS (
    SELECT kll_sketch_agg_float(score) AS sketch
    FROM VALUES (1.5), (2.3), (3.7) AS T(score)
  )
  SELECT kll_sketch_get_quantile_float(sketch, 0.5) FROM sketch_data
  2.3