Looker（Google Cloud コア）を使用して、各インスタンスに含まれる接続から基本的なデータモデルを自動的に生成する方法について説明します。
各 Looker（Google Cloud コア）インスタンスには、デフォルトでサンプルの LookML プロジェクトがインストールされています。LookML プロジェクトのサンプルには、BigQuery の一般公開データセット the Look eCommerce に基づく、キュレートされた LookML モデルが含まれています。サンプルの LookML プロジェクトでは、接続 sample_bigquery_connection を使用しています。この接続を使用して、サンプル プロジェクトのテーブルに基づく新しいデータモデルを生成できます。このクイックスタートは学習目的のみを対象としているため、プロセスの最後にデータモデルを削除します。
始める前に
このクイックスタートを行うには、次のものが必要です。
- サンプルの LookML プロジェクトを含む Looker（Google Cloud コア）インスタンスへのアクセス権。
- Looker 管理者 IAM ロールを持つユーザーが、Looker（Google Cloud コア）インスタンスを含む Google Cloud プロジェクトで BigQuery API を有効にする必要があります。
- Looker 管理者のロールまたは
develop権限が必要です。
[モデルの作成] ページに移動します。
- Looker（Google Cloud コア）のホームページで、メイン ナビゲーション メニューの [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の右側にある矢印をクリックして、[フィールド] フィールドに移動します。- [フィールド] フィールドですべてのフィールドを選択し、[次へ] をクリックします。
- [主キーの選択] セクションで、主キーとして [名前] を選択し、[次へ] をクリックします。
- [作成するデータ探索を選択] セクションで
bq_table.viewファイルを選択し、[次へ] をクリックします。 - [Enter Model Name] セクションに、一意のモデル名を入力します。
- [完了してモデルを表示] ボタンをクリックします。このアクションにより、Looker IDE が開きます。
モデルを表示する
[モデルを作成する] ページのすべてのフィールドを入力したら、Looker が生成したモデルを表示します。
Looker IDE でモデルファイルを表示する
- [Complete and View Model] ボタンをクリックすると、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モデルとともに表示されます。
モデルによって作成されたデータ探索を表示する
- [Projects] ページでモデルの名前をクリックして、IDE のモデルファイルに戻ります。
- IDE でモデルファイルを開き、IDE の上部にあるファイル名の横にある [ファイルの操作を表示] 矢印をクリックします。
- プルダウン メニューから [Explore Bq Table - your_model_name] を選択します。これを選択すると、モデルによって作成された Bq テーブル Explore に移動します。
- フィールド ピッカーで、この [モデルを作成する] ページで選択した [Birthdate Date]、[Name]、[Rating] ディメンションと、デフォルトの [Count] 指標をメモします。
表示したモデルファイル、モデル構成、Explore は、Development Mode の間は個人の Git ブランチでのみ使用できます。このモデルを Looker（Google Cloud コア）インスタンス内の他のユーザーが利用できるようにするには、変更を commit し、ブランチをマージして本番環境ブランチをデプロイします。ただし、このクイックスタートでは、次のセクションで説明するように、このモデルを削除します。
クリーンアップ
Looker のパフォーマンスを最大限に引き出すには、不要なモデルを本番環境にデプロイしないでください。クリーンな個人の Git ブランチを維持し、このモデルを誤って本番環境にデプロイしないようにするには、次の手順でモデルを削除します。
- Explore で、フィールド ピッカーの [LookML に移動] リンクをクリックします。このアクションにより、Looker IDE が開きます。
- IDE で [Git Actions] アイコンを選択します。
- [Git Actions] メニューで [Revert to] をクリックします。
[元に戻す] ウィンドウで、[commit していない変更を元に戻す] オプションが選択されていることを確認し、[確認] をクリックします。
IDE にモデルファイルが表示されなくなります。
モデル構成を削除するには、[Develop] メニューで [Projects] をクリックして [Projects] ページに移動します。
表でモデルを見つけて、その行の [設定] ボタンをクリックします。
[モデル] フィールドで名前を確認して、モデルのウィンドウに移動していることを確認し、[モデル構成を削除] をクリックします。