モデルの一覧表示

概要

このページでは、データセット内の BigQuery ML モデルを一覧表示する方法について説明します。BigQuery ML モデルは、次の方法で一覧表示できます。

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

必要な権限

データセット内のモデルを一覧表示するには、データセットに対して READER 役割を割り当てるか、bigquery.models.list 権限を含むプロジェクト レベルの IAM 役割を割り当てる必要があります。プロジェクト レベルで bigquery.models.list 権限が付与されている場合は、プロジェクト内の任意のデータセットのテーブルを一覧表示できます。次の事前定義されたプロジェクト レベルの IAM 役割には、bigquery.models.list 権限が含まれています。

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

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

モデルの一覧表示

データセット内のモデルを一覧表示する手順は、以下のとおりです。

Console

  1. GCP Console の BigQuery ウェブ UI に移動します。

    BigQuery ウェブ UI に移動

  2. ナビゲーション パネルの [リソース] セクションで、プロジェクト名をクリックします。

  3. プロジェクト内の各データセットを展開すると、データセット内の他の BigQuery リソースとともに、モデルが一覧表示されます。モデルにはモデルアイコン モデルアイコン がついています。

CLI

--models または -m フラグを指定して bq ls コマンドを実行します。--format フラグを使用して出力結果を操作できます。デフォルト プロジェクト以外のプロジェクトで、モデルを一覧表示する場合は、プロジェクト ID を [PROJECT_ID]:[DATASET] の形式でデータセットに追加します。

bq ls -m --format=pretty [PROJECT_ID]:[DATASET]

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

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

--format=pretty フラグを使用すると、コマンド出力は次のようになります。--format=pretty を指定すると、フォーマットされたテーブルが出力されます。Model Type 列に、モデルタイプが表示されます(例: KMEANS)。

+-------------------------+------------+--------+-----------------+
|           Id            | Model Type | Labels |  Creation Time  |
+-------------------------+------------+--------+-----------------+
| mymodel                 | KMEANS     |        | 03 May 03:02:27 |
+-------------------------+------------+--------+-----------------+

次に例を示します。

次のコマンドを入力すると、デフォルト プロジェクトの mydataset データセット内のモデルを一覧表示します。

bq ls --models --format=pretty mydataset

次のコマンドを入力すると、myotherprojectmydataset データセット内のモデルを一覧表示します。このコマンドは -m ショートカットを使用して、モデルを一覧表示します。

bq ls -m --format=pretty myotherproject:mydataset

API

API を使用してモデルを一覧表示するには、models.list メソッドを呼び出して projectIddatasetId を指定します。

次のステップ

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

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

BigQuery ML のドキュメント