Fonction ML.CENTROIDS
La fonction ML.CENTROIDS
affiche des informations sur les centroïdes dans un modèle de k-moyennes.
ML.CENTROIDS
affiche les colonnes suivantes :
- centroid_id : entier permettant d'identifier le centroïde.
- feature : nom de la colonne qui contient la caractéristique.
- numerical_value : Si
feature
est une valeur numérique, il s'agit de la valeur defeature
pour le centroïde identifié parcentroid_id
. Sifeature
n'est pas une valeur numérique, la valeur estNULL
. - categorical_value : tableau de structures contenant des informations sur les caractéristiques catégorielles. Chaque structure contient les champs suivants :
- categorical_value.category : nom de chaque catégorie.
- categorical_value.value : Valeur de
categorical_value.category
pour le centroïde identifié parcentroid_id
.
- geography_value : Si
feature
est de typeGEOGRAPHY
, il s'agit de la valeur defeature
pour le centroïde identifié parcentroid_id
. Sinon, il s'agit d'une valeurNULL
.
Le résultat de cette fonction contient une ligne par caractéristique par centroïde.
Syntaxe de ML.CENTROIDS
ML.CENTROIDS(MODEL `project_id.dataset.model`)
project_id
est l'ID de votre projet.dataset
est l'ensemble de données BigQuery contenant le modèle.model
est le nom du modèle.
Exemples d'instructions ML.CENTROIDS
L'exemple suivant récupère les informations de centroïde du modèle de k-moyennes model
dans dataset
. Ce modèle contient des caractéristiques numériques.
SELECT * FROM ML.CENTROIDS(MODEL `project_id.dataset.model`)
Cette requête affiche ce type de résultats :
+-------------+-------------------+----------------------+---------------------+ | centroid_id | feature | numerical_value | categorical_value | +-------------+-------------------+----------------------+---------------------+ | 3 | x_coordinate | 3095929.0 | [] | | 3 | y_coordinate | 1.0089726307692308E7 | [] | | 2 | x_coordinate | 3117072.65625 | [] | | 2 | y_coordinate | 1.0083220745833334E7 | [] | | 1 | x_coordinate | 3259947.096227731 | [] | | 1 | y_coordinate | 1.0105690227895036E7 | [] | | 4 | x_coordinate | 3109887.9056603773 | [] | | 4 | y_coordinate | 1.0057112358490566E7 | [] | +-------------+-------------------+----------------------+---------------------+
L'exemple suivant récupère les informations de centroïde du modèle de k-moyennes model
dans dataset
. Ce modèle contient des caractéristiques catégorielles.
SELECT * FROM ML.CENTROIDS(MODEL `project_id.dataset.model`) ORDER BY centroid_id;
Cette requête affiche ce type de résultats :
+-------------+-------------------+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | centroid_id | feature |numerical_value| categorical_value | +-------------+-------------------+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 1 | department | NULL | [{"category":"Medieval Art","feature_value":"1.0"}] | | 1 | medium | NULL | [{"category":"Iron","feature_value":"0.21602160216021601"},{"category":"Glass, ceramic","feature_value":"0.3933393339333933"},{"category":"Copper alloy","feature_value":"0.39063906390639064"}] | | 2 | medium | NULL | [{"category":"Wood, gesso, paint","feature_value":"0.15"},{"category":"Carnelian","feature_value":"0.2692307692307692"},{"category":"Papyrus, ink","feature_value":"0.2653846153846154"},{"category":"Steatite, glazed","feature_value":"0.3153846153846154"}] | | 2 | department | NULL | [{"category":"Egyptian Art","feature_value":"1.0"}] | | 3 | medium | NULL | [{"category":"Faience","feature_value":"1.0"}] | | 3 | department | NULL | [{"category":"Egyptian Art","feature_value":"1.0"}] | | 4 | medium | NULL | [{"category":"Steatite","feature_value":"1.0"}] | | 4 | department | NULL | [{"category":"Egyptian Art","feature_value":"1.0"}] | | 5 | medium | NULL | [{"category":"Red quartzite","feature_value":"0.20316027088036118"},{"category":"Bronze or copper alloy","feature_value":"0.3476297968397291"},{"category":"Gold","feature_value":"0.4492099322799097"}] | | 5 | department | NULL | [{"category":"Egyptian Art","feature_value":"1.0"}] | +-------------+-------------------+---------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Voici les résultats de cette même requête sur un modèle de k-moyennes contenant des caractéristiques numériques et catégorielles.
+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | centroid_id | feature | numerical_value | categorical_value | +-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 1 | start_station_name | NULL | [{"category":"Toomey Rd @ South Lamar","value":"0.5714285714285714"},{"category":"State Capitol @ 14th & Colorado","value":"0.42857142857142855"}] | | 1 | duration_minutes | 9.142857142857142 | [] | | 2 | duration_minutes | 9.0 | [] | | 2 | start_station_name | NULL | [{"category":"Rainey @ River St","value":"0.14285714285714285"},{"category":"11th & San Jacinto","value":"0.42857142857142855"},{"category":"ACC - West & 12th Street","value":"0.14285714285714285"},{"category":"East 11th St. at Victory Grill","value":"0.2857142857142857"}] | +-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+