Função width_bucket

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna o número do bucket para um valor em um histograma de equilargura.

Sintaxe

width_bucket(expr, minExpr, maxExpr, numBuckets)

Argumentos

  • expr: Uma expressão numérica ou de intervalo a ser agrupada.
  • minExpr: Uma expressão numérica ou intervalar que fornece um limite inferior para os buckets.
  • maxExpr: Uma expressão numérica ou intervalar que fornece um limite superior para os buckets.
  • numBuckets: Uma expressão INTEGER maior que 0 especificando o número de buckets.

Se expr é numérico, minExpr e maxExpr também deve ser numérico.

Se expr é um intervalo, minExpr e maxExpr deve ser do mesmo tipo de intervalo.

O intervalo é suportado desde: Databricks Runtime 10.1

Devoluções

Um INTEIRO.

A função divide o intervalo entre minExpr e maxExpr em numBuckets fatias de tamanho igual. O resultado é a fatia em que expr cai.

Se expr estiver fora do minExpr resultado é 0.

Se expr estiver fora do maxExpr resultado é numbuckets + 1

minExpr pode ser maior que maxExpr.

Exemplos

> 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