Delen via

width_bucket-functie

  • Artikel

Van toepassing op: vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Retourneert het bucketnummer voor een waarde in een histogram met gelijke breedte.

Syntaxis

width_bucket(expr, minExpr, maxExpr, numBuckets)

Argumenten

  • expr: Een numerieke expressie of intervalexpressie die moet worden gebucket.
  • minExpr: Een numerieke expressie of intervalexpressie die een ondergrens voor de buckets biedt.
  • maxExpr: Een numerieke expressie of intervalexpressie die een bovengrens voor de buckets aangeeft.
  • numBuckets: Een INTEGER-expressie groter dan 0 die het aantal buckets aangeeft.

Als expr numeriek is en minExpr maxExpr ook numeriek moet zijn.

Als expr dit een interval is en maxExpr minExpr van hetzelfde intervaltype moet zijn.

Interval wordt ondersteund sinds: Databricks Runtime 10.1

Retouren

Een GEHEEL GETAL.

De functie verdeelt het bereik tussen minExpr en maxExpr in numBuckets segmenten van gelijke grootte. Het resultaat is het segment waarin expr valt.

Als expr het resultaat buiten minExpr het resultaat valt, is 0.

Als expr het resultaat buiten maxExpr het resultaat valt numbuckets + 1

minExpr kan groter zijn dan maxExpr.

Voorbeelden

> SELECT width_bucket(5.3, 0.2, 10.6, 5);
 3
> SELECT width_bucket(-2.1, 1.3, 3.4, 3);
 0
> SELECT width_bucket(8.1, 0.0, 5.7, 4);
 5
> SELECT width_bucket(-0.9, 5.2, 0.5, 2);
 3

> SELECT width_bucket(INTERVAL '1' DAY, INTERVAL '0' DAY, INTERVAL '10' DAY, 11);
2