funktion kll_sketch_get_quantile_double

Gäller för: Databricks Runtime 18.0 och senare

Beräknar värdet vid en viss kvantilrankning (eller flera rangordningar) från en dubbel KLL-skiss.

Syntax

kll_sketch_get_quantile_double ( sketch, rank )

Arguments

• sketch: Ett BINARY uttryck som innehåller en serialiserad DOUBLE KLL-skiss.
• rank: Ett DOUBLE uttryck eller ARRAY<DOUBLE> en kvantil rangordnas mellan 0,0 och 1,0, där:
  • 0,0 är minimum,
  • 0,5 är medianvärdet och
  • 1.0 är maxvärdet.

Retur

• Om rangordningen är DOUBLE: returnerar ett DOUBLE värde som representerar den uppskattade kvantilen.
• Om rangordningen är ARRAY<DOUBLE>: returnerar ARRAY<DOUBLE> med kvantiluppskattningar för varje rangordning.

Noteringar

• Rangordningen måste vara mellan 0,0 och 1,0 inklusive.
• Returnerar NULL om skissen är tom.
• Vanliga quantiles: 0,25 (Q1), 0,5 (median), 0,75 (Q3), 0,95 (P95), 0,99 (P99).

Vanliga felvillkor

• KLL_INVALID_INPUT_SKETCH_BUFFER
• KLL_SKETCH_INVALID_QUANTILE_RANGE

Examples

> WITH sketch_data AS (
    SELECT kll_sketch_agg_double(value) AS sketch
    FROM VALUES (1.23), (2.34), (3.45) AS T(value)
  )
  SELECT kll_sketch_get_quantile_double(sketch, array(0.25, 0.75)) FROM sketch_data
  [1.23, 3.45]

Relaterade funktioner

• kll_sketch_agg_bigint aggregatfunktion
• kll_sketch_agg_double aggregatfunktion
• kll_sketch_agg_float aggregatfunktion
• kll_sketch_get_rank_double funktion