WIDTH_BUCKET

Mit WIDTH_BUCKET können Sie einen Histogrammbereich erstellen, der in Intervalle mit identischer Größe unterteilt ist. Die Funktion gibt die Bucket-Nummer zurück, in die der Wert eines Ausdrucks fällt.

Falls erforderlich erstellt WIDTH_BUCKET ein Underflow Bucket mit der Nummer 0 und ein Overflow Bucket mit der Nummer num_buckets+1. Diese Buckets verarbeiten Werte außerhalb des angegebenen Bereichs. Mit ihnen kann bestimmt werden, ob die Endpunkte vernünftig sind.

Rückgabewert

NUMBER

Syntax

WIDTH_BUCKET
   (expr, min_value, max_value, num_buckets)

Argumente

expr ist der Ausdruck, für den das Histogramm erstellt wird. Die Auswertung dieses Ausdrucks muss einen numerischen oder Datetime-Wert oder einen Wert ergeben. Wenn die Auswertung vonexpr Null ergibt, gibt die Funktion Null zurück.

min_value und max_value sind Ausdrücke für die Endpunkte des annehmbaren Bereichs für expr. Die Auswertung beider Ausdrücke muss numerische oder Datetime-Werte ergeben. Die Auswertung darf in beiden Fällen nicht Null ergeben.

num_buckets ist ein Ausdruck für die Anzahl von Buckets (Speicherbereichen). Die Auswertung dieses Ausdrucks muss eine positive Ganzzahl ergeben.

Beispiel

WIDTH_BUCKET(13, 0, 20, 4) gibt den Wert 3 zurück. Die Funktion erstellt vier Buckets von 0 bis 20 und sortiert den Wert 13 in Bucket 3.

WIDTH_BUCKET(-5, 0, 20, 4) gibt den Wert 0 zurück. Der Wert -5 liegt unter dem Anfang des Bereichs.