Fonction ML.CENTROIDS

ML.CENTROIDS fonction

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 de feature pour le centroïde identifié par centroid_id. Si feature n'est pas une valeur numérique, la valeur est NULL.
  • 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é par centroid_id.
  • geography_value : Si feature est de type GEOGRAPHY, il s'agit de la valeur de feature pour le centroïde identifié par centroid_id. Sinon, il s'agit d'une valeur NULL.

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"}] |
+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+