LookML でデータをモデル化

LookML と Looker IDE を使用すると、データベース テーブルに基づいて再利用可能なデータモデル、ディメンション、リレーションシップを定義できます。このクイックスタートでは、Looker（Google Cloud コア）のサンプル LookML プロジェクトを使用して、モデルファイルとビューファイルを作成し、Explore を構成して、新しいディメンションをテストします。また、Development Mode を有効にする方法、Looker IDE を操作する方法、クイックヘルプを使用する方法についても学習します。

始める前に

このクイックスタートに沿って作業を進めるには、次のものが必要です。

  • Looker（Google Cloud コア）インスタンスへのアクセス:

必要なロール

このクイックスタートを完了するには、適切な 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 ユーザー アカウントが必要です。

Development Mode をオンにする

Looker プロジェクトは、本番環境モードと Development Mode の 2 つのモードのいずれかで存在できます。Development Mode では、LookML ファイルを変更し、それらがインスタンスのコンテンツに与える影響をプレビューできます。このとき、本番環境（他のユーザーに表示される内容）には影響しません。詳細については、Development Mode と 本番環境モード のドキュメント ページをご覧ください。

このクイックスタートでは、LookML ファイルに変更を加え、Explore で変更をテストできるように、Development Mode を使用します。

Development Mode を有効にする手順は次のとおりです。

  1. Looker（Google Cloud コア）のホームページで、Looker のメインメニュー アイコン をクリックして、メイン ナビゲーション メニューを展開します（まだ展開されていない場合）。
  2. メニューの下部にある [Development Mode] 切り替えボタンを選択します。

Development Mode が有効になっている場合、Looker の画面上部に Development Mode バナーが表示されます。

LookML プロジェクトは、データベースへの接続方法、データのクエリ方法、ユーザー インターフェースでのデータの表示方法を Looker に指示する LookML ファイルのコレクションです。このクイックスタートでは、Looker（Google Cloud コア）インスタンスで自動的に構成されるサンプル LookML プロジェクトを使用します。

Looker IDE でサンプル LookML プロジェクト ファイルに移動するには、次の手順を行います。

  1. Looker のメインメニュー アイコン をクリックし、[開発] メニューがまだ表示されていない場合は、[開発] を選択します。
  2. [Develop] メニューで、[sample_thelook_ecommerce] を選択します。

Looker IDE の [ファイル ブラウザ] パネルが開き、サンプルの LookML プロジェクト ファイルが表示されます。

新しいプロジェクト フォルダを作成する

このクイックスタートで作成するファイルを LookML サンプル プロジェクトの他のファイルと区別するため、クイックスタート ファイル用の新しいプロジェクト フォルダを作成します。

プロジェクトにフォルダを作成する手順は次のとおりです。

  1. Looker IDE の [ファイル ブラウザ] パネルで、パネルの上部にある [ファイルまたはフォルダを追加] アイコンをクリックし、[ファイルまたはフォルダを追加] メニューから [フォルダを作成] オプションを選択します。

  2. 新しいフォルダの名前として「quickstart」と入力します。

  3. [作成] をクリックします。

Looker IDE の [File Browser] パネルに新しいフォルダが追加されます。

IDE フォルダに関する追加情報

LookML プロジェクトでフォルダを使用する方法については、次のドキュメント ページをご覧ください。

  • 今後独自のフォルダとファイルを作成する方法と、プロジェクトでフォルダを作成する際の考慮事項については、LookML ファイルとフォルダの管理に関するドキュメント ページをご覧ください。
  • Looker IDE ファイル ブラウザの詳細については、IDE ファイル ブラウザでの操作のドキュメント ページをご覧ください。

新しい LookML モデルファイルを作成する

LookML モデルファイルは、データベース接続と、その接続を使用する一連の Looker Explore を指定します。Explore は、LookML でデータがモデル化された後に、ユーザーが Looker でデータをクエリするための出発点です（Looker での Explore の表示と操作をご覧ください）。

LookML プロジェクトで新しいモデルファイルを作成する手順は次のとおりです。

  1. Looker IDE の [ファイル ブラウザ] パネルで、新しいプロジェクト フォルダを作成するの手順で作成した quickstart フォルダの 3 点リーダーの [フォルダ オプション] メニューを選択します。
  2. [フォルダ オプション] メニューから [モデルを作成] を選択します。
  3. [Create File] ダイアログで、新しいファイルの名前 quickstart_practice を入力し、[Create] をクリックします。Looker で quickstart フォルダの下に quickstart_practice.model ファイルが作成され、Looker IDE で新しいファイルが開きます。[ファイル ブラウザ] パネルで、ファイルの横に青い点が表示されているのは、ファイルが新規作成されたことを示しています。
  4. [File Browser] パネルで、quickstart フォルダをクリックして展開し、quickstart_practice.model ファイルを表示します。
  5. Looker IDE で、quickstart_practice.model ファイルをクリックして開きます（まだ開いていない場合）。

quickstart_practice.model ファイルには、プロジェクトの開始点として使用できる LookML の例が含まれています。現時点では、ファイルはそのままにしておきます。このクイックスタートの後半で、モデルファイルに Explore を作成します。

モデルファイルに関する追加情報

今後独自のモデルファイルを作成する場合は、次のリソースに注意してください。

新しい LookML ビューファイルを作成する

LookML では、ビューはデータベース内の単一のテーブルまたは単一の派生テーブルのいずれかに対応します。ビューファイルは、クエリするデータベース内のテーブルと、そのデータベース テーブルから取り込むフィールド（ディメンションおよびメジャー）を指定します。ビューファイルでフィールドを定義したら、$ 置換演算子を使用して、LookML の他の部分でフィールドを参照できます。これにより、フィールドを 1 か所で定義しながら、LookML プロジェクトの複数の場所で使用できます。

新しいビューファイルを作成する方法はいくつかありますが、最も簡単な方法は、Looker 自体にデータベース内の既存のテーブルに基づいてビューファイルを自動的に生成させることです。

Looker で新しいビューファイルを生成する手順は次のとおりです。

  1. Looker IDE の [ファイル ブラウザ] パネルで、新しいプロジェクト フォルダを作成するの手順で作成した quickstart フォルダの 3 点リーダーの [フォルダ オプション] メニューを選択します。
  2. [フォルダ オプション] メニューから [テーブルからビューを作成] を選択します。

  3. [Create Views from Tables] ページで、[Enter custom db] 入力フィールドをクリックし、「bigquery-public-data」と入力します。

    [テーブルからビューを作成] ダイアログ。

  4. Enter キーを押して、BigQuery の一般公開データセットを表示します。

  5. リストをスクロールして、thelook_ecommerce データセットを見つけます。

  6. thelook_ecommerce データセットをクリックして開きます。

  7. order_items テーブルを選択します。

  8. ページの下部にある [Create Views] ボタンをクリックします。

Looker IDE に order_items ビューファイルが表示されます。[File Browser] パネルで、quickstart フォルダが展開され、order_items ビューファイルが青い点付きで表示されます。これは、新しいファイルであることを示しています。

ビューファイルに関する追加情報

今後独自のビューファイルを作成する場合は、次のリソースに注意してください。

Looker IDE のクイックヘルプ

これで、LookML モデルファイルと LookML ビューファイルが作成されました。このクイックスタートの次のステップでは、これらのファイルの編集を開始します。編集を開始する前に、Looker IDE のクイックヘルプ機能について理解しておく必要があります。[クイックヘルプ] パネルには、LookML ファイル内の現在のカーソル位置の説明とオプションが表示されます。

  • IDE エディタパネルで、LookML ファイルのフィールドとパラメータをクリックすると、[クイックヘルプ] パネルに、その LookML 要素でサポートされているオプションとサブパラメータが表示されます。
  • [クイックヘルプ] パネルでパラメータ名をクリックすると、そのパラメータの Looker ドキュメント ページが開きます。

[クイックヘルプ] パネルがまだ開いていない場合は、Looker IDE の [クイックヘルプ] アイコンをクリックして開くことができます。

ビューの Explore を作成する

新しい LookML モデルファイルを作成する手順と新しい LookML ビューファイルを作成する手順を完了したら、新しいビューファイルの Explore を定義して、Looker を使用してビューファイルでモデル化したデータをクエリできるようにします。

Explore は通常、モデルファイルで定義されます。（別の Explore ファイルを作成することもできますが、このクイックスタートでは、モデルファイルに Explore を作成します）。

Explore を定義する LookML ファイルでは、Explore の定義でビューファイルを参照できるように、include パラメータを使用する必要があります。この手順では、これらのステップについて説明します。

order_items ビューファイルの Explore を作成する手順は次のとおりです。

  1. Looker IDE で、quickstart_practice.model ファイルを開きます。

  2. quickstart_practice.model ファイルで、include パラメータを含む既存の行を次の行に置き換えます。

    include: "/quickstart/order_items.view"

  3. include パラメータの下に新しい行を追加し、次の LookML を入力します。 none explore: order_items {}

  4. Looker IDE の上部にある [Save Changes] ボタンをクリックします。

この Explore は、ユーザーが order_items ビューをクエリできるようにする Explore の最も基本的な例です。この開始点から、さまざまな方法で Explore を構築できます。

Explore に関する追加情報

今後、独自の Explore を作成して Explore を構築するには、次のリソースに注意してください。

新しいフィールドを作成する

このクイックスタートの新しい LookML ビューファイルを作成するセクションでビューファイルを作成すると、Looker が自動的に作成したフィールドを確認できます。データベース テーブルに基づくビューファイルを作成すると、Looker はディメンション、ディメンション グループ、メジャーを自動的に作成します。

  • ディメンションは、属性、ファクト、または値を表すフィールドです。ユーザーは Explore 内のフィールド ピッカーから選択でき、クエリのフィルタリングに使用できます。フィールドが SUM、COUNT などの集計関数内にない場合、それはディメンションです。Looker は、データベース テーブルの各列のディメンションを自動的に作成します。
  • ディメンション グループは、時間ベースまたは期間ベースのディメンションのセットを一度に作成するために使用されます。たとえば、タイムスタンプ列のディメンション グループには、日付、月、四半期、時刻、週、年の個々のディメンションが含まれます。Looker は、データベース テーブルで検出された時間ベースのフィールドに対してディメンション グループを自動的に作成します。
  • measure は、合計やカウントなど、データに関する測定可能な情報を表す Explore のフィールドです。measure はビューファイルで宣言され、集約または非集計の型を指定できます。Looker は、ビューファイルに type:count のメジャーを自動的に作成します。これは、SQL の COUNT(*) に相当します。

このセクションでは、order_items ビューファイルに独自のディメンションを手動で追加する方法について説明します。

order_items ビューファイルに新しいディメンションを手動で作成する手順は次のとおりです。

  1. quickstarts/order_items.view ファイルがまだ開いていない場合は、開きます。Looker IDE の [ファイル ブラウザ] パネルで、[quickstart] フォルダをクリックして展開し、order_items.view ファイルをクリックして開きます。
  2. quickstarts/order_items.view ファイルで、ファイル内の最初の dimension パラメータの前に新しい行を作成します。

  3. 新しい行で「dimension」と入力します。入力を開始すると、入力したテキストで始まる使用可能なパラメータのリストが Looker IDE に表示されます。

    • 矢印キーを使用して、候補リストの dimension オプションに移動します。
    • Enter キーを押して、選択したパラメータを LookML に挿入します。Looker により、作成した新しい行に新しい dimension パラメータが挿入されます。

  4. 新しいディメンションの名前を指定するには、IDE で {} の前をクリックして shipped_to_delivered_days と入力します。

  5. {} 内をクリックし、Enter キーを押して {} 内に新しい行を作成します。

  6. 新しいディメンションの LookML を完成させます（次の LookML をコピーして貼り付けるか、LookML を手動で入力して、Looker IDE がどのようにガイダンスを提供するかを確認します）。

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. Looker IDE の上部にある [Save Changes] ボタンをクリックします。

Looker は、新しいディメンションを含むビューファイルを保存します。ファイル内の新しい行については、Looker IDE で行番号が緑色で表示されます。

LookML フィールドに関する追加情報

今後独自のフィールドを作成する場合は、次のリソースに注意してください。

Looker UI で変更を表示してテストする

ビューの Explore を作成するの手順で order_items ビューファイルの Explore を作成した場合は、Looker の Explore UI に新しいディメンションが表示されます。

Looker UI の Explore で変更を表示してテストする手順は次のとおりです。

  1. Looker IDE の quickstarts/order_items.view ファイルで、ファイル エディタ パネルの上部にあるビューファイルの名前の横にある [ファイル アクションを表示] 矢印アイコンをクリックし、[Explore Order Items - quickstart_practice] オプションを選択します。

    [ファイル 操作メニュー] で [Explore Order Items - quickstart_practice] オプションが選択されている。

  2. [Order Items] Explore フィールド ピッカーで、[Other Dates] グループラベルをクリックして展開し、[Shipped to Delivered Days] ディメンションをクリックして Explore に追加します。（フィールド ピッカーの検索ボックスに「Shipped to Delivered Days」と入力してディメンションを検索することもできます）。

  3. [Order Items] Explore フィールド ピッカーで、[Shipped Date] グループラベルをクリックして展開し、[Date] ディメンションをクリックして Explore に追加します。

  4. [Order Items] Explore フィールド ピッカーで、[Delivered Date] グループラベルをクリックして展開し、[Date] ディメンションをクリックして Explore に追加します。

  5. Explore の上部にある [実行] ボタンをクリックします。

Looker がクエリを実行し、Explore の [データ] セクションに結果が表示されます。各行で、[Order Items Shipped to Delivered Days] の値が、[Order Items Shipped Date] の値と [Order Items Delivered Date] の値の間の正しい日数を示していることを確認できます。

LookML を検証する

このクイックスタートでは、LookML を検証する必要はありません。ただし、今後、独自のプロジェクトを作成してデータをモデリングする際には、LookML を検証するための Looker ツールについて知っておくと便利です。

LookML を編集すると、Looker IDE は、単一のファイル内の未解決の構文エラーについて警告します（Looker IDE の概要のドキュメント ページをご覧ください）。また、完全なモデル検証を実行して、LookML にエラーがないか確認することもできます。詳細については、LookML の検証のドキュメント ページをご覧ください。

変更を commit します。

このクイックスタートでは、サンプルの LookML プロジェクト用に設定された、事前構成済みの Git 接続を使用します。ただし、今後、データをモデル化するために独自のプロジェクトを作成する場合は、プロジェクトに Git 接続を設定する必要があります。

LookML プロジェクト ファイルに変更を加えると、Looker IDE の右上にある Git ボタンにさまざまなオペレーションが表示されます。このボタンには、LookML の検証と変更の本番環境へのデプロイのプロセスをガイドするさまざまなオペレーションが表示されます。

このクイックスタートで表示した LookML ファイルと Explore は、Development Mode の個人用 Git ブランチでのみ使用できます。このモデルを Looker（Google Cloud コア）インスタンスの他のユーザーが利用できるようにするには、変更を commit し、ブランチをマージして、本番環境ブランチをデプロイします。

このクイックスタートでは、変更を本番環境にデプロイしません。代わりに、クリーンアップの手順に沿って、これらのファイルを削除します。

クリーンアップ

Looker のパフォーマンスを最大化するには、不要なモデルを本番環境にデプロイしないでください。個人の Git ブランチをクリーンな状態に保ち、これらのファイルが誤って本番環境にデプロイされないようにするには、次の手順に沿って、このクイックスタートで作成したファイルを削除します。

  1. Looker のメインメニュー アイコン をクリックし、[開発] メニューがまだ表示されていない場合は、[開発] を選択します。
  2. [Develop] メニューで、[sample_thelook_ecommerce] を選択します。
  3. Looker IDE の [ファイル ブラウザ] パネルで、新しいプロジェクト フォルダを作成するの手順で作成した quickstart フォルダの 3 点リーダーの [フォルダ オプション] メニューを選択します。
  4. [フォルダ オプション] メニューから [削除] を選択します。
  5. [フォルダを削除] ウィンドウで [削除] をクリックします。

Looker は quickstart フォルダとそのすべてのコンテンツを削除します。

次のステップ