WIDTH_BUCKET

WIDTH_BUCKET permite construir un rango de histograma dividido en intervalos de idéntico tamaño. Esta función devuelve el número de cubo en el que entra el valor de la expresión.

Si se necesita, WIDTH_BUCKET crea un cubo de subdesbordamiento con el número 0 y un cubo de desbordamiento con el número num_buckets+1. Estos cubos manejan los valores que están fuera del rango especificado y son útiles para comprobar si los puntos finales son razonables.

Valor de Retorno

NUMBER

Sintaxis

WIDTH_BUCKET
   (expr, min_value, max_value, num_buckets)

Argumentos

expr es la expresión para la que se crea el histograma. Esta expresión se debe evaluar en un valor numérico, de fecha/hora o en otro valor. Si expr se evalúa en un valor nulo, la función devuelve nulo.

min_value y max_value son expresiones para los puntos finales del rango aceptable para expr. Ambas expresiones se deben evaluar en valores numéricos o de fecha/hora; ninguna se puede evaluar en nulo.

num_buckets es la expresión que corresponde al número de cubos. Esta expresión se debe evaluar en un entero positivo.

Ejemplo

WIDTH_BUCKET(13, 0, 20, 4) devuelve el valor 3. Crea 4 cubos de 0 a 20 y ordena el valor 13 en el cubo 3.

WIDTH_BUCKET(-5, 0, 20, 4) devuelve el valor 0. El valor -5 es inferior al principio del rango.