モデルの管理

このページでは、モデルのコピーやモデル名の変更など、BigQuery ML モデルの管理方法について説明します。

モデル名の変更

現在、既存のモデル名は変更できません。モデル名を変更するには、手順に従ってモデルをコピーしてください。コピー先を指定するには、新しいモデル名を使用してください。

モデルのコピー

次の方法で、1 つ以上のモデルをソースデータセットからコピー先のデータセットにコピーできます。

Google Cloud コンソールを使用する。
bq コマンドラインツールの bq cp コマンドを使用する。
jobs.insert API メソッドを直接呼び出して、コピージョブを構成するか、クライアントライブラリを使用する。

モデルのコピーに関する制限

モデルのコピージョブには、以下の制限があります。

モデルをコピーするときは、モデルの作成時と同じ命名規則に従って、コピー先モデルに名前を付ける必要があります。
モデルのコピーには、コピージョブに関する BigQuery ML の上限が適用されます。
現在、Google Cloud コンソールでは、モデルのコピーはサポートされていません。
モデルをコピーする際には、コピー先のデータセットが、コピー元のモデルが格納されているデータセットと、同じロケーションにある必要があります。たとえば、EU にあるデータセットからモデルをコピーして、US にあるデータセットに書き込むことはできません。
単一のコマンドで、複数のソースモデルをコピーすることはできません。
CLI を使用してモデルをコピーする際、現在のところ、--destination_kms_key フラグはサポートされていません。

モデルのコピー

次の方法で、モデルをコピーできます。

コマンドラインツールの bq cp コマンドを使用する
jobs.insert API メソッドを呼び出して、コピージョブを構成するか、クライアントライブラリを使用する。

モデルをコピーするには:

コンソール

現在、Google Cloud コンソールではモデルのコピーはサポートされていません。

bq

bq cp コマンドを発行します。オプションフラグ:

-f または --force を指定すると、コピー先データセット内の既存のモデルが上書きされます。確認を求めるプロンプトは表示されません。
-n または --no_clobber を指定すると、コピー先データセット内にモデルが存在している場合に '[PROJECT_ID]:[DATASET].[MODEL]' already exists, skipping というエラーメッセージが返されます。

-n を指定していない場合、デフォルトの動作として、コピー先モデルを置き換えるかどうかの選択を求めるプロンプトが表示されます。

コピー元またはコピー先のデータセットがデフォルト以外のプロジェクトにある場合は、[PROJECT_ID]:[DATASET] の形式でプロジェクト ID をデータセット名に追加します。

--location フラグを指定して、その値をロケーションに設定します。

bq --location=[LOCATION] cp -f -n [PROJECT_ID]:[DATASET].[SOURCE_MODEL] [PROJECT_ID]:[DATASET].[DESTINATION_MODEL]

ここで

[LOCATION] はロケーションの名前です。--location フラグは省略可能です。たとえば、BigQuery ML を東京リージョンで使用している場合は、このフラグの値を asia-northeast1 に設定します。.bigqueryrc ファイルを使用してロケーションのデフォルト値を設定できます。
[PROJECT_ID] はプロジェクト ID です。
[DATASET] は、コピー元またはコピー先データセットの名前です。
[SOURCE_MODEL] は、コピー中のモデルです。
[DESTINATION_MODEL] は、コピー先データセット内のモデルの名前です。

例:

mydataset.mymodel を mydataset2 にコピーするには、次のコマンドを入力します。どちらのデータセットもデフォルトプロジェクト内にあり、US マルチリージョンロケーションに作成されています。

bq --location=US cp mydataset.mymodel mydataset2.mymodel

mydataset.mymodel をコピーして、コピー先にある同じ名前のモデルを上書きするには、次のコマンドを入力します。コピー元データセットはデフォルトプロジェクトにあり、コピー先データセットは myotherproject にあります。-f ショートカットが指定されているため、コピー先モデルは確認プロンプトなしで上書きされます。mydataset と myotherdataset は US マルチリージョンロケーションに作成されています。

bq --location=US cp -f mydataset.mymodel myotherproject:myotherdataset.mymodel

mydataset.mymodel をコピーして、コピー先データセットに同じ名前のモデルがある場合にエラーを返すには、次のコマンドを入力します。コピー元データセットはデフォルトプロジェクトにあり、コピー先データセットは myotherproject にあります。同じ名前のモデルの上書きを防ぐために、-n ショートカットを使用します。どちらのデータセットも US マルチリージョンロケーションに作成されています。

bq --location=US cp -n mydataset.mymodel myotherproject:myotherdataset.mymodel

mydataset.mymodel を mydataset2 にコピーして、モデル mymodel2 の名前を変更するには、次のコマンドを入力します。データセットは両方ともデフォルトプロジェクトにあり、どちらのデータセットも asia-northeast1 リージョンに作成されています。

bq --location=asia-northeast1 cp mydataset.mymodel mydataset2.mymodel2

API

API を使用してモデルをコピーするには、bigquery.jobs.insert メソッドを呼び出し、copy ジョブを構成します。ジョブリソースの jobReference セクションにある location プロパティでロケーションを指定します。

ジョブ構成で次の値を指定する必要があります。

"copy": {
      "sourceTable": {       // Required
        "projectId": string, // Required
        "datasetId": string, // Required
        "tableId": string    // Required
      },
      "destinationTable": {  // Required
        "projectId": string, // Required
        "datasetId": string, // Required
        "tableId": string    // Required
      },
      "createDisposition": string,  // Optional
      "writeDisposition": string,   // Optional
    },

ここで

sourceTable は、コピーするモデルに関する情報です。
destinationTable は、新しいモデルに関する情報です。
createDisposition では、モデルが存在しない場合にモデルを作成するかどうかを指定します。
writeDisposition では、既存のモデルを上書きするかどうかを指定します。

次のステップ

BigQuery ML の概要で BigQuery ML の概要を確認する。
BigQuery ML を使ってみる。Google Cloud コンソールを使用した BigQuery ML スタートガイドをご覧ください。
モデルを使った作業の詳細を確認する。以下をご覧ください。