Fonction ML.BUCKETIZE
Ce document décrit la fonction ML.BUCKETIZE
, qui vous permet de diviser une expression numérique en buckets.
Syntaxe
ML.BUCKETIZE(numerical_expression, array_split_points [, exclude_boundaries])
Arguments
ML.BUCKETIZE
utilise les arguments suivants :
numerical_expression
: expression numérique à diviser en buckets.array_split_points
: tableau de valeurs numériques fournissant les points auxquels diviser la valeurnumerical_expression
. Indiquez les valeurs numériques dans l'ordre, de la plus faible à la plus élevée. La plage de buckets possibles est déterminée par les limites supérieure et inférieure du tableau. Par exemple, si la valeur dearray_split_points
est[1, 2, 3, 4]
, la valeur denumerical_expression
peut potentiellement être divisée en cinq buckets.exclude_boundaries
: valeurBOOL
qui détermine si les valeurs limites supérieure et inférieure dearray_split_points
sont utilisées. Si la valeur estTRUE
, les valeurs limites ne sont pas utilisées pour créer des buckets. Par exemple, si la valeur dearray_split_points
est[1, 2, 3, 4]
et queexclude_boundaries
estTRUE
, la valeur denumerical_expression
peut potentiellement être divisée en trois buckets. La valeur par défaut estFALSE
.
Sortie
ML.BUCKETIZE
renvoie une valeur STRING
qui contient le nom du bucket.
Les noms de buckets renvoyés sont au format bin_<bucket_index>
, avec bucket_index
commençant à 1
.
Exemple
L'exemple suivant divise une expression numérique en buckets avec et sans valeurs limites :
SELECT ML.BUCKETIZE(2.5, [1, 2, 3]) AS bucket, ML.BUCKETIZE(2.5, [1, 2, 3], TRUE) AS bucket_without_boundaries;
La sortie ressemble à ceci :
+---------+----------------------------+ | bucket | bucket_without_boundaries | +---------+----------------------------+ | bin_3 | bin_2 | +---------+----------------------------+
Étapes suivantes
- Pour en savoir plus sur le prétraitement des caractéristiques, consultez la page Présentation du prétraitement des caractéristiques.
- Pour en savoir plus sur les instructions et les fonctions SQL compatibles avec chaque type de modèle, consultez la section Parcours utilisateur de bout en bout pour chaque modèle.