LookML でデータをモデル化する

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

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

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

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

始める前に

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

Development Mode をオンにする

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

新しいフォルダが Looker IDE の [ファイル ブラウザ] パネルに追加されます。

IDE フォルダの追加情報

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

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

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

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

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

  1. Looker IDE の [ファイル ブラウザ] パネルで、新しいプロジェクト フォルダを作成する手順で作成した quickstart フォルダの三点メニューの [フォルダ オプション] を選択します。
  2. [フォルダ オプション] メニューで [モデルを作成] を選択します。
  3. [Create File] ダイアログで、新しいファイルの名前 quickstart_practice を入力し、[Create] をクリックします。Looker は quickstart フォルダに quickstart_practice.model ファイルを作成し、Looker IDE で新しいファイルを開きます。[ファイル ブラウザ] パネルのファイルの横にある青いドットは、ファイルが新しいことを示します。
  4. [ファイル ブラウザ] パネルで 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 で [クイックヘルプ] アイコンをクリックして開きます。

ビューの Explore を作成する

新しい 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 の上部にある [変更を保存] ボタンをクリックします。

この Explore は、ユーザーが order_items ビューをクエリできる 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 の上部にある [変更を保存] ボタンをクリックします。

新しいディメンションを含むビュー ファイルが保存されます。ファイル内の新しい行の場合、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] オプションを選択します。

    [ファイル アクションを表示] メニューで、[注文アイテムを探索 - 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. データ探索の上部にある [実行] ボタンをクリックします。

Looker がクエリを実行し、結果を Explore の [データ] セクションに表示します。行ごとに、[注文アイテムの発送から配達までの日数] の値が、[注文アイテムの発送日] の値と [注文アイテムの配達日] の値の間の正しい日数を示していることを確認します。

LookML を検証する

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

LookML を編集すると、Looker IDE は 1 つのファイル内で未解決の構文エラーをアラートします（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 フォルダとそのすべてのコンテンツを削除します。

次のステップ