WIDTH_BUCKET

WIDTH_BUCKET permite construir um histograma dividido em intervalos de tamanhos idênticos. A função retorna o número do recipiente onde está o valor de uma expressão.

Quando necessário, WIDTH_BUCKET cria um recipiente de baixo fluxo com o número 0 e um de alto fluxo com o número num_buckets+1. Esses recipientes tratam de valores fora do intervalo especificado e são úteis na verificação da exatidão dos pontos finais.

Valor de Retorno

NUMBER

Sintaxe

WIDTH_BUCKET
   (expr, min_value, max_value, num_buckets)

Argumentos

expr é a expressão para a qual o histograma está sendo criado. Essa expressão deve ser avaliada como um valor numérico ou de data e hora. Se expr for avaliada como nula, a função retornará nula.

min_value e max_value são expressões dos pontos finais do intervalo aceitável da expr. Ambas as expressões devem ser avaliadas como valores numéricos ou de data e hora, e nenhuma delas podem ser nula.

num_buckets é uma expressão do número de recipientes. Essa expressão deve ser avaliada como um número inteiro positivo.

Exemplo

WIDTH_BUCKET(13, 0, 20, 4) retorna o valor 3. Cria quatro recipientes de 0 a 20 e reduz o valor 13 para o recipiente 3.

WIDTH_BUCKET(-5, 0, 20, 4) retorna o valor 0. O valor -5 está abaixo do início do intervalo.