サンプルデータからモデルを生成する
Looker（Google Cloud コア）を使用して、各インスタンスに含まれる接続から基本的なデータモデルを自動的に生成する方法について説明します。
各 Looker（Google Cloud コア）インスタンスには、インスタンスにデフォルトでインストールされる LookML プロジェクトのサンプルが付属しています。LookML プロジェクトのサンプルには、BigQuery の一般公開データセット the Look eCommerceに基づく、キュレートされた LookML モデルが含まれています。LookML プロジェクトのサンプルでは、接続 sample_bigquery_connectionを使用します。この接続を使用して、サンプル プロジェクトのテーブルのいずれかに基づく新しいデータモデルを生成できます。このクイックスタートは説明のみを目的としているため、プロセスの最後にデータモデルを削除します。
始める前に
このクイックスタートの手順に沿って操作するには、次のものが必要です。
- LookML プロジェクトのサンプルを含む Looker（Google Cloud コア）インスタンスへのアクセス。
- Looker（Google Cloud コア）インスタンスを含む Google Cloud プロジェクトで BigQuery API を有効にします。
必要なロール
このクイックスタートを完了するには、適切な Identity and Access Management（IAM）ロールと Looker ロールが必要です。
Identity and Access Management ロール
Looker（Google Cloud コア）管理者は、 Google Cloudの Identity and Access Management システムを介して Looker（Google Cloud コア）アプリケーションへのアクセス権を付与します。
Looker（Google Cloud コア）アプリケーションにアクセスするために必要な権限を取得するには、Looker（Google Cloud コア）インスタンスを含むプロジェクトに対するLooker インスタンス ユーザー （roles/looker.instanceUser）IAM ロールを付与するよう管理者に依頼してください。 Google Cloud ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
この事前定義ロールには、Looker（Google Cloud コア）アプリケーションにアクセスするために必要な権限が含まれています。looker.instances.login
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
Looker の権限
Looker 管理者 ロールまたは develop 権限が必要です。
[モデルを作成] ページに移動する
- Looker（Google Cloud コア）のホームページで、Looker の [Main menu] アイコン をクリックし、メニューの下部にある [Development Mode] 切り替えを選択して Development Mode を有効にします。
- Looker（Google Cloud コア）のホームページで、メイン ナビゲーション メニューの [作成] ボタンをクリックしてプルダウン メニューを開きます。
- プルダウン メニューから [LookML モデル] を選択して、[モデルを作成] ページを開きます。
モデルを定義する
[モデルを作成] ページで、次の操作を行います。
- [データベース接続を選択] セクションで、プルダウン メニューから
sample_bigquery_connectionを選択します。 - ラジオボタンを選択してモデルを
sample_thelook_ecommerceプロジェクトに追加し、[次へ] をクリックします。 - [テーブルを選択] セクションで、デフォルトの Google Cloud プロジェクトを [GCP プロジェクトを選択] フィールドのままにします。
- [データセット] フィールドで、
bq_datasetを選択します。 bq_datasetの右にある矢印をクリックして、[テーブル] フィールドに移動します。- [テーブル] フィールドで、
bq_tableを選択します。 bq_tableの右にある矢印をクリックして、[フィールド] フィールドに移動します。- [フィールド] フィールドで、すべてのフィールドを選択し、[次へ] をクリックします。
- [主キーを選択] セクションで、主キーとして [名前] を選択し、[次へ] をクリックします。
- [作成する Explore を選択] セクションで、
bq_table.viewファイルを選択し、[次へ] をクリックします。 - [モデル名を入力] セクションで、一意のモデル名を入力します。
- [完了してモデルを表示] ボタンをクリックします。この操作により、Looker IDE が表示されます。
モデルを表示する
[モデルを作成] ページのすべてのフィールドに入力したら、Looker が生成したモデルを表示します。
Looker IDE でモデルファイルを表示する
- [完了してモデルを表示] ボタンをクリックすると、Looker IDE が表示されます。IDE のファイル ブラウザには、既存の LookML モデルのサンプル（
0_start_here、1_basic_lookml、2_intermediate_lookml、3_advanced_lookml）のフォルダが表示されます。生成されたモデル用に作成されたフォルダ（modelsとviews）も表示されます。 modelsフォルダとviewsフォルダを開いて、[モデルを作成] ページで定義したモデル用に Looker が作成した LookML ファイルを表示します。各ファイルの横にある青い点は、新しいファイルであり、まだ本番環境にデプロイされていないことを示します。- Looker が生成した
README.mdファイルも表示されます。これは、[モデルを作成] ページの [LookML の使用に関する詳細情報を提供する Readme ファイルを生成する] チェックボックスがデフォルトでオンになっているためです。
[LookML プロジェクト] ページでモデルを表示する
- IDE で、[メインメニュー] アイコンをクリックしてメイン ナビゲーション メニューを開きます。
- まだ [開発] メニューに移動していない場合は、[開発] をクリックします。
- [開発] メニューから [プロジェクト] を選択して、[LookML プロジェクト] ページに移動します。
- [sample_thelook_ecommerce] 行の [モデル] 列でモデルを表示します。LookML プロジェクトのサンプルから、
advanced_ecomm、basic_ecomm、intermediate_ecommモデルとともに表示されます。
モデルによって作成された Explore を表示する
- [プロジェクト] ページで、モデルの名前をクリックして IDE のモデルファイルに戻ります。
- IDE でモデルファイルを開いた状態で、IDE の上部にあるファイル名の横にある [ファイル操作を表示] 矢印をクリックします。
- プルダウン メニューから [Explore Bq Table- your_model_name] を選択します。この選択により、モデルによって作成された [Bq Table] Explore に移動します。
- フィールド ピッカーで、この [**モデルを作成**] ページで選択した**生年月日** 、**名前** 、**評価** のディメンションと、デフォルトの**カウント** メジャーを確認します。
表示したモデルファイル、モデル構成、Explore は、Development Mode の個人用 Git ブランチでのみ使用できます。このモデルを Looker（Google Cloud コア）インスタンスの他のユーザーが使用できるようにするには、変更を commit してブランチをマージし、本番環境ブランチをデプロイします。ただし、このクイックスタートでは、次のセクションで説明するように、このモデルを削除します。
クリーンアップ
Looker のパフォーマンスを最大限に高めるには、不要なモデルを本番環境にデプロイしないでください。個人用 Git ブランチをクリーンな状態に保ち、このモデルを誤って本番環境にデプロイしないようにするには、次の手順でモデルを削除します。
- Explore で、フィールド ピッカーの [Go to LookML] リンクをクリックします。この操作により、Looker IDE が表示されます。
- IDE で、[Git Actions] アイコンを選択します。
- [Git Actions] メニューで、[Revert to] をクリックします。
[Revert to] ウィンドウで、[Revert uncommitted changes] オプションが選択されていることを確認し、[Confirm] をクリックします。
IDE にモデルファイルが表示されなくなります。
モデル構成を削除するには、[開発] メニューの [プロジェクト] をクリックして、[プロジェクト] ページに移動します。
テーブルでモデルを見つけて、その行の [構成] ボタンをクリックします。
[モデル] フィールドの名前を確認して、モデルのウィンドウが表示されていることを確認し、[モデル構成を削除] をクリックします。