サンプルデータからモデルを生成
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 コア）インスタンスを含む Google Cloud プロジェクトに対する Looker インスタンス ユーザー （roles/looker.instanceUser）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
この事前定義ロールには、Looker（Google Cloud コア）アプリケーションにアクセスするために必要な looker.instances.login 権限が含まれています。
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
Looker の権限
Looker 管理者ロールまたは develop 権限が必要です。
[モデルの作成] ページに移動する
- Looker（Google Cloud コア）のホームページで、Looker のメインメニュー アイコン をクリックし、メニューの下部にある [Development Mode] 切り替えを選択して Development Mode を有効にします。
- Looker（Google Cloud コア）のホームページで、メイン ナビゲーション メニューの [作成] ボタンをクリックしてプルダウン メニューを開きます。
- プルダウン メニューから [LookML モデル] を選択して、[モデルを作成] ページを開きます。
モデルの定義
[モデルの作成] ページで、次の操作を行います。
- [データベース接続を選択] セクションで、プルダウン メニューから [
sample_bigquery_connection] を選択します。 - ラジオボタンを選択してモデルを
sample_thelook_ecommerceプロジェクトに追加し、[次へ] をクリックします。 - [テーブルを選択] セクションで、[GCP プロジェクトを選択] フィールドのデフォルトの Google Cloud プロジェクトはそのままにします。
- [データセット] フィールドで、[
bq_dataset] を選択します。 bq_datasetの右側にある矢印をクリックして、[Tables] フィールドに移動します。- [Tables] フィールドで
bq_tableを選択します。 bq_tableの右側にある矢印をクリックして、[フィールド] フィールドに移動します。- [フィールド] フィールドで、すべてのフィールドを選択し、[次へ] をクリックします。
- [主キーの選択] セクションで、主キーとして [名前] を選択し、[次へ] をクリックします。
- [Select Explores to Create] セクションで
bq_table.viewファイルを選択し、[Next] をクリックします。 - [モデル名を入力] セクションに、一意のモデル名を入力します。
- [完了してモデルを表示] ボタンをクリックします。このアクションにより、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 ファイルが表示されます。各ファイルの横にある青い点は、それらが新しいファイルであり、まだ本番環境にデプロイされていないことを示しています。- また、[モデルの作成] ページの [LookML の使用方法を詳細に説明する Readme ファイルを生成します] チェックボックスがデフォルトでオンになっているため、Looker が生成した
README.mdファイルも表示されます。
LookML プロジェクト ページでモデルを表示する
- IDE で、[メインメニュー] アイコンをクリックしてメイン ナビゲーション メニューを開きます。
- [Develop] メニューが表示されていない場合は、[Develop] をクリックします。
- [開発] メニューから [プロジェクト] を選択して、LookML プロジェクト ページに移動します。
- sample_thelook_ecommerce 行の [モデル] 列でモデルを確認します。サンプル LookML プロジェクトの
advanced_ecomm、basic_ecomm、intermediate_ecommモデルとともに表示されます。
モデルによって作成された Explore を表示する
- [プロジェクト] ページでモデルの名前をクリックして、IDE のモデルファイルに戻ります。
- IDE でモデルファイルを開き、IDE の上部にあるファイル名の横にある [See file actions] 矢印をクリックします。
- プルダウン メニューから [Explore Bq Table- your_model_name] を選択します。この選択により、モデルによって作成された Bq テーブルの Explore に移動します。
- フィールド ピッカーで、この [モデルを作成] ページで選択した [生年月日]、[名前]、[評価] の各ディメンションと、デフォルトの [カウント] メジャーを確認します。
表示したモデルファイル、モデル構成、Explore は、Development Mode の間は個人の Git ブランチでのみ使用できます。このモデルを Looker（Google Cloud コア）インスタンスの他のユーザーが使用できるようにするには、変更を commit し、ブランチをマージして、本番環境ブランチをデプロイします。ただし、このクイックスタートでは、次のセクションで説明するように、このモデルを削除します。
クリーンアップ
Looker のパフォーマンスを最大限に高めるには、不要なモデルを本番環境にデプロイしないでください。個人用の Git ブランチをクリーンな状態に保ち、このモデルが誤って本番環境にデプロイされないようにするには、次の手順でモデルを削除します。
- Explore で、フィールド ピッカーの [LookML に移動] リンクをクリックします。このアクションにより、Looker IDE が開きます。
- IDE で、[Git アクション] アイコンを選択します。
- [Git アクション] メニューで [元に戻す] をクリックします。
[Revert to] ウィンドウで、[Revert uncommitted changes] オプションが選択されていることを確認し、[Confirm] をクリックします。
IDE にモデルファイルが表示されなくなります。
モデル構成を削除するには、[Develop] メニューの [Projects] をクリックして、[Projects] ページに移動します。
テーブルでモデルを見つけて、その行の [構成] ボタンをクリックします。
[モデル] フィールドの名前を確認して、モデルのウィンドウにいることを確認し、[モデル構成の削除] をクリックします。