モデル メタデータの取得

概要

このページでは、BigQuery ML モデルに関する情報やメタデータを取得する方法について説明します。モデルのメタデータは、次の方法で取得できます。

  • GCP Console を使用する
  • bq show CLI コマンドを使用する
  • models.get API メソッドを直接またはクライアント ライブラリを使用して呼び出す

必要な権限

モデル メタデータを取得するには、データセットに対して READER 役割を割り当てるか、bigquery.models.getMetadata 権限を含むプロジェクト レベルの IAM 役割を割り当てる必要があります。プロジェクト レベルで bigquery.models.getMetadata 権限が付与されている場合は、プロジェクト内の任意のデータセットのモデルに関するメタデータを取得できます。次の定義済みのプロジェクト レベルの IAM 役割には、bigquery.models.getMetadata アクセス許可が含まれています。

  • bigquery.dataViewer
  • bigquery.dataEditor
  • bigquery.dataOwner
  • bigquery.metadataViewer
  • bigquery.admin

BigQuery ML での IAM 役割と権限の詳細については、アクセス制御をご覧ください。データセット レベルの役割の詳細については、BigQuery のドキュメントのデータセットの基本の役割をご覧ください。

モデル メタデータの取得

モデルに関するメタデータを取得するには、次の操作を行います。

Console

  1. ナビゲーション パネルの [リソース] セクションでプロジェクトを展開し、データセットを選択します。

  2. モデル名をクリックします。

  3. クエリエディタ ボックスの下にある [詳細] をクリックします。このページには、説明、ラベル、詳細、トレーニング オプションを含むモデルのメタデータが表示されます。

    Google Cloud Platform Console でのモデル メタデータ

CLI

モデル メタデータを表示するには、--model または -m フラグを指定して bq show コマンドを実行します。--format フラグを使用して出力結果を操作できます。

モデルの機能の列のみを参照するには、--model フラグと一緒に --schema フラグを使用します。--schema フラグを使用する場合、--format フラグを jsonprettyjson のどちらかに設定する必要があります。

デフォルト プロジェクト以外のプロジェクトのモデルに関する情報を取得するには、プロジェクト ID を [PROJECT_ID]:[DATASET] の形式でデータセットに追加します。

bq show --model --format=prettyjson [PROJECT_ID]:[DATASET].[MODEL]

各項目の説明は次のとおりです。

  • [PROJECT_ID] はプロジェクト ID です。
  • [DATASET] はデータセットの名前です。
  • [MODEL] はモデルの名前です。

--format=pretty フラグを使用すると、コマンド出力は次のようになります。詳細を表示するには、--format=prettyjson 形式を使用してください。出力例は、ロジスティック回帰モデルのメタデータです。

+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
|      Id      |     Model Type      |   Feature Columns   |       Label Columns       | Labels |  Creation Time  | Expiration Time |
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
| sample_model | LOGISTIC_REGRESSION | |- column1: string  | |- label_column: int64    |        | 03 May 23:14:42 |                 |
|              |                     | |- column2: bool    |                           |        |                 |                 |
|              |                     | |- column3: string  |                           |        |                 |                 |
|              |                     | |- column4: int64   |                           |        |                 |                 |
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+

例:

次のコマンドを入力して、mydataset にある mymodel に関するすべての情報を表示します。mydataset はデフォルト プロジェクトにあります。

bq show --model --format=prettyjson mydataset.mymodel

次のコマンドを入力して、mydataset にある mymodel に関するすべての情報を表示します。mydatasetmyotherproject にあり、デフォルトのプロジェクトにはありません。

bq show --model --format=prettyjson myotherproject:mydataset.mymodel

次のコマンドを入力して mydataset にある mymodel の機能の列のみを表示します。mydatasetmyotherproject にあり、デフォルトのプロジェクトにはありません。

bq show --model --schema --format=prettyjson \
myotherproject:mydataset.mymodel

API

API を使用してモデルのメタデータを取得するには、models.get メソッドを呼び出して projectIddatasetIdmodelId を指定します。

次のステップ

このページは役立ちましたか?評価をお願いいたします。

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