Fonction width_bucket

  • Article

S’applique à :case marquée oui Databricks SQL case marquée oui Databricks Runtime

Retourne le numéro de compartiment pour une valeur dans un histogramme equi-width.

Syntaxe

width_bucket(expr, minExpr, maxExpr, numBuckets)

Arguments

  • expr : une expression numérique ou d’intervale à compartimenter.
  • minExpr : une expression numérique ou d’intervalle fournissant une limite inférieure pour les compartiments.
  • maxExpr : une expression numérique ou d’intervalle fournissant une limite supérieure pour les compartiments.
  • numBuckets : expression de type entier supérieure à 0 spécifiant le nombre de compartiments.

Si expr est une valeur numérique, minExpr et maxExpr doivent aussi être des valeurs numériques.

Si expr est un intervalle, minExpret maxExpr doit être du même type d’intervalle.

L’intervalle est pris en charge depuis : Databricks Runtime 10.1

Retours

Un ENTIER.

La fonction divise la plage comprise entre minExpr et maxExpr en numBuckets sections de taille égale. Le résultat est la section dans laquelle expr se retrouve.

Si expr est en dehors de minExpr, le résultat est de 0.

Si expr est en dehors de maxExpr, le résultat est numbuckets + 1

minExpr peut être supérieur à maxExpr.

Exemples

> 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