Compartilhar via

Função width_bucket

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Retorna o número do bucket de um valor em um histograma de largura de equivalência.

Sintaxe

width_bucket(expr, minExpr, maxExpr, numBuckets)

Argumentos

  • expr: uma expressão ou intervalo numérico a ser particionada em bucket.
  • minExpr: uma expressão ou intervalo numérico que fornece um limite inferior para os buckets.
  • maxExpr: uma expressão ou intervalo numérico que fornece um limite superior para os buckets.
  • numBuckets: uma expressão INTEGER maior que 0 especificando o número de buckets.

Se expr for numérico, minExpr e maxExpr também devem ser numéricos.

Se expr for um intervalo, minExpr e maxExpr precisar ser do mesmo tipo de intervalo.

O intervalo é compatível desde o: Databricks Runtime 10.1

Retornos

Um INTEGER.

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

Se expr estiver fora de minExpr, o resultado será 0.

Se expr estiver fora de maxExpr, o resultado será 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