ML.CENTROIDS-Funktion

ML.CENTROIDS-Funktion

ML.CENTROIDS gibt Informationen zu den Schwerpunkten in einem k-Means-Modell zurück.

ML.CENTROIDS gibt die folgenden Spalten zurück:

  • centroid_id: Eine Ganzzahl, die den Schwerpunkt angibt.
  • feature: Der Spaltenname, der das Feature enthält.
  • numerical_value: Wenn feature numerisch ist, ist dies der Wert von feature für den Schwerpunkt, den centroid_id identifiziert. Ist feature nicht numerisch, ist der Wert NULL.
  • categorical_value: Ein ARRAY von STRUCTs mit Informationen zu kategorialen Features. Jeder STRUCT enthält die folgenden Felder:
    • categorical_value.category: Der Name jeder Kategorie.
    • categorical_value.value: Der Wert von categorical_value.category für den Schwerpunkt, den centroid_id identifiziert.
  • geography_value: Wenn für feature der Typ GEOGRAPHY gilt, ist dies der Wert von feature für den Schwerpunkt, den centroid_id identifiziert. Wenn nicht, ist der Wert NULL.

Die Ausgabe enthält eine Zeile pro Feature und Schwerpunkt.

ML.CENTROIDS-Syntax

ML.CENTROIDS(MODEL `project_id.dataset.model`)
  • project_id ist die Projekt-ID.
  • dataset ist das BigQuery-Dataset, das das Modell enthält.
  • model ist der Name des Modells.

Beispiele für ML.CENTROIDS

Im folgenden Beispiel werden Schwerpunktinformationen aus dem k-Means-Modell model in dataset abgerufen. Dieses Modell enthält numerische Features.

SELECT
  *
FROM
  ML.CENTROIDS(MODEL `project_id.dataset.model`)

Diese Abfrage gibt Ergebnisse wie die folgenden zurück:

+-------------+-------------------+----------------------+---------------------+
| 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 |                  [] |
+-------------+-------------------+----------------------+---------------------+

Im folgenden Beispiel werden Schwerpunktinformationen aus dem k-Means-Modell model in dataset abgerufen. Dieses Modell enthält kategoriale Features:

SELECT
  *
FROM
  ML.CENTROIDS(MODEL `project_id.dataset.model`)
ORDER BY
  centroid_id;

Diese Abfrage gibt Ergebnisse wie die folgenden zurück:

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

Im Folgenden sind die Ergebnisse der gleichen Abfrage für ein k-Means-Modell sowohl mit numerischen als auch mit kategorialen Features dargestellt:

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