LookML でデータをモデル化

LookML と Looker IDE を使用して、構造化された再利用可能な方法でデータをモデル化する方法を学びます。

Looker でデータをモデル化する最も簡単な方法は、データベース内のテーブルに基づいて LookML ファイルを自動的に生成させることです。この操作は、サンプルデータからモデルを生成するクイックスタートで練習できます。手順の詳細については、LookML モデルの生成に関するドキュメント ページをご覧ください。

このクイックスタートでは、LookML ファイルをプロジェクトに手動で追加する方法と、新しい LookML 要素を手動で作成する方法について説明します。これにより、特定のデータとニーズに合わせて LookML プロジェクトをカスタマイズできます。このクイックスタートでは、LookML モデルファイルと LookML ビューファイルを手動で作成し、ビューの Explore を作成し、ビューファイルに新しいディメンションを作成し、Explore UI で新しい指標をテストする手順について説明します。このクイックスタートでは、開発モードの有効化、Looker IDE の操作、Looker IDE のクイックヘルプ機能の使用についても説明します。このクイックスタートでは、これらのトピックの詳細を確認するための関連ドキュメントへのリンクも提供します。

このクイックスタートでは、出発点として、Looker（Google Cloud コア）インスタンスで自動的に構成されるサンプル LookML プロジェクトを使用します。

始める前に

このクイックスタートを行うには、次のものが必要です。

開発モードをオンにする

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

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

開発モードを有効にする手順は次のとおりです。

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

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

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

Looker IDE でサンプルの LookML プロジェクト ファイルに移動する手順は次のとおりです。

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

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

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

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

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

  1. Looker IDE の [File Browser] パネルで、パネルの上部にある [Add file or folder] アイコンをクリックし、[Add file or folder] メニューから [Create Folder] オプションを選択します。

  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 の他の部分でフィールドを参照できます。これにより、LookML プロジェクト内の複数の場所からフィールドを使用しながら、1 か所でフィールドを定義できます。

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

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

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

  3. [テーブルからビューを作成する] ページで、[Enter custom db] 入力フィールドをクリックし、bigquery-public-data と入力します。

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

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

  5. thelook_ecommerce データセットが見つかるまでリストをスクロールします。

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

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

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

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

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

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

Looker IDE クイックヘルプ

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

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

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

ビューの探索を作成する

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

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

Explore を定義する LookML ファイルで include パラメータを使用すると、Explore 定義でビューファイルを参照できます。この手順では、これらの手順について説明します。

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 に挿入します。作成した新しい行に、新しい 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 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] オプションを選択します。

    [See file actions] メニューで、[Explore Order Items - quickstart_practice] オプションが選択されています。

  2. [Order Items] データ探索フィールド ピッカーで、[その他の日付] グループラベルをクリックして展開し、[発送から納品までの日数] ディメンションをクリックしてデータ探索に追加します。（フィールド選択ツールの検索ボックスに 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 のメインメニュー アイコン をクリックし、[Develop] メニューが表示されていない場合は [Develop] を選択します。
  2. [Develop] メニューから [sample_thelook_ecommerce] を選択します。
  3. Looker IDE の [ファイル ブラウザ] パネルで、新しいプロジェクト フォルダを作成する手順で作成した quickstart フォルダの 3 点リーダーの [フォルダ オプション] メニューを選択します。
  4. [フォルダ オプション] メニューから [削除] を選択します。
  5. [フォルダを削除] ウィンドウで [削除] をクリックします。

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

次のステップ