The ML.BUCKETIZE function

This document describes the ML.BUCKETIZE function, which lets you split a numerical expression into buckets.

Syntax

ML.BUCKETIZE(numerical_expression, array_split_points [, exclude_boundaries])

Arguments

ML.BUCKETIZE takes the following arguments:

Output

ML.BUCKETIZE returns a STRING value that contains the name of the bucket. The returned bucket names are in the format of bin_<bucket_index>, with bucket_index starting at 1.

Example

The following example bucketizes a numerical expression both with and without boundaries:

SELECT
  ML.BUCKETIZE(2.5, [1, 2, 3]) AS bucket,
  ML.BUCKETIZE(2.5, [1, 2, 3], TRUE) AS bucket_without_boundaries;

The output looks similar to the following:

+---------+----------------------------+
| bucket  | bucket_without_boundaries  |
+---------+----------------------------+
| bin_3   | bin_2                      |
+---------+----------------------------+

What's next