WIDTH_BUCKET

WIDTH_BUCKET consente di creare un istogramma suddiviso in intervalli della stessa dimensione. La funzione restituisce il numero di bucket in cui è compreso il valore di un'espressione.

Se necessario, WIDTH_BUCKET crea un bucket di underflow con numero 0 e un bucket di overflow con numero num_buckets+1. Questi bucket gestiscono i valori non compresi nell'intervallo specificato e sono utili nella verifica dell'appropriatezza degli endpoint.

Valore restituito

NUMBER

Sintassi

WIDTH_BUCKET
   (expr, min_value, max_value, num_buckets)

Argomenti

expr è l'espressione per la quale l'istogramma viene creato. L'espressione deve restituire un valore numerico o data/ora oppure un altro valore. Se expr restituisce null, la funzione restituisce null.

min_value e max_value sono espressioni per gli endpoint dell'intervallo accettabile per expr. Entrambe queste espressioni devono restituire valori numerici o data/ora e nessuna delle due può restituire null.

num_buckets è un'espressione per il numero di bucket. Tale espressione deve restituire un numero intero positivo.

Esempio

WIDTH_BUCKET(13, 0, 20, 4) restituisce il valore 3. Crea quattro bucket da 0 a 20 e ordina il valore 13 nel bucket 3.

WIDTH_BUCKET(-5, 0, 20, 4) restituisce il valore 0. Il valore -5 è al di sotto dell'inizio dell'intervallo.