ML.CENTROIDS 関数

ML.CENTROIDS 関数

ML.CENTROIDS は、K 平均法モデルセントロイドに関する情報を返します。

ML.CENTROIDS は次の列を返します。

  • centroid_id。セントロイドを識別する整数。
  • feature。機能を含む列名。
  • numerical_valuefeature が数値の場合、centroid_id で識別されるセントロイドの feature の値。feature が数値でない場合、値は NULL です。
  • categorical_value。カテゴリ特徴に関する情報を含む STRUCT の ARRAY。各 STRUCT には次のフィールドが含まれます。
    • categorical_value.category。各カテゴリの名前。
    • categorical_value.valuecentroid_id で識別されるセントロイドの categorical_value.category の値。
  • geography_valuefeature のタイプが GEOGRAPHY の場合、centroid_id で識別されるセントロイドの feature の値。それ以外の場合、値は NULL です。

出力は、セントロイドごと、特徴ごとに 1 行ずつです。

ML.CENTROIDS の構文

ML.CENTROIDS(MODEL `project_id.dataset.model`)
  • project_id はプロジェクト ID です。
  • dataset は、モデルを含む BigQuery データセットです。
  • model は、モデルの名前です。

ML.CENTROIDS の例

次の例では、dataset 内の K 平均法モデル model から、セントロイド情報を取得します。このモデルには数値特徴が含まれます。

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

このクエリは、次のような結果を返します。

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

次の例では、dataset 内の K 平均法モデル model から、セントロイド情報を取得します。このモデルにはカテゴリ特徴が含まれます。

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

このクエリは、次のような結果を返します。

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

同じクエリを数値特徴とカテゴリ特徴の両方をもつ K 平均法モデルに対して行った結果は次のとおりです。

+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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"}] |
+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...