Freigeben über

kll_sketch_get_quantile_bigint-Funktion

Gilt für:Ja, mit Häkchen markiert Databricks Runtime 18.0 und höher

Schätzt den Wert bei einer bestimmten Quantile-Rangfolge (oder mehreren Rängen) aus einer ganzzahligen KLL-Skizze.

Syntax

kll_sketch_get_quantile_bigint ( sketch, rank )

Arguments

  • sketch: Ein BINARY Ausdruck, der eine serialisierte ganzzahlige KLL-Skizze enthält.
  • rank: Ein DOUBLE Ausdruck oder ARRAY<DOUBLE> quantile rangiert zwischen 0,0 und 1,0, wobei:
    • 0,0 ist das Minimum,
    • 0,5 ist der Median und
    • 1,0 ist das Maximum.

Rückkehr

  • Wenn rangfolge lautet DOUBLE: gibt einen BIGINT Wert zurück, der das geschätzte Quantile darstellt.
  • Wenn "Rang" lautet ARRAY<DOUBLE>: gibt ARRAY<BIGINT> mit Quantile-Schätzungen für jeden Rang zurück.

Hinweise

  • Der Rang muss zwischen 0,0 und einschließlich 1,0 liegen.
  • Gibt zurück NULL , wenn die Skizze leer ist.
  • Allgemeine Quantiles: 0,25 (Q1), 0,5 (Median), 0,75 (Q3), 0,95 (P95), 0,99 (P99).

Examples

-- Get median from a sketch
> WITH sketch_data AS (
    SELECT kll_sketch_agg_bigint(value) AS sketch
    FROM VALUES (1), (2), (3), (4), (5) AS T(value)
  )
  SELECT kll_sketch_get_quantile_bigint(sketch, 0.5) FROM sketch_data
  3
-- Get multiple quantiles (Q1, median, Q3)
> WITH sketch_data AS (
    SELECT kll_sketch_agg_bigint(value) AS sketch
    FROM VALUES (1), (2), (3), (4), (5) AS T(value)
  )
  SELECT kll_sketch_get_quantile_bigint(sketch, array(0.25, 0.5, 0.75)) FROM sketch_data
  [2, 3, 4]
-- Get P95 and P99 for latency monitoring
> WITH sketch_data AS (
    SELECT kll_sketch_agg_bigint(latency_ms) AS sketch FROM latency_table
  )
  SELECT kll_sketch_get_quantile_bigint(sketch, array(0.95, 0.99)) FROM sketch_data
  [145, 234]
  • Last updated on