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
featureest une valeur numérique, il s'agit de la valeur defeaturepour le centroïde identifié parcentroid_id. Sifeaturen'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.categorypour le centroïde identifié parcentroid_id.
- geography_value : Si
featureest de typeGEOGRAPHY, il s'agit de la valeur defeaturepour 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_idest l'ID de votre projet.datasetest l'ensemble de données BigQuery contenant le modèle.modelest 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"}] |
+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+