このドキュメント ページでは、[モデルを作成] ページを使用してデータベース接続から基本的な LookML モデルを自動的に生成する手順について説明します。[モデルを作成] ページを使用して、モデルを格納するプロジェクトを作成することもできます。
モデルファイルを作成する方法は他にもあります。
- モデルファイルやその他のプロジェクト ファイルは、IDE から手動で作成できます。
従来の方法でプロジェクトを作成してモデルを生成するには、次のいずれかをクリックして、従来の [新しいプロジェクト] ページに移動します。
- [モデルを作成] ページ上部のバナーにあるリンク
- [プロジェクト] ページの [保留中のプロジェクト] セクションにある [LookML を追加する] ボタン
[新しいプロジェクト] ページに移動したら、新しい LookML プロジェクトの作成のドキュメントの手順に沿って操作します。
[モデルの作成] ページにアクセスする
次の方法で [モデルを作成] ページにアクセスします。
[モデルの作成] ページにアクセスするには、Development Mode になっている必要があります。
[モデルを作成] ページにアクセスするには、Looker の管理者であるか、develop
権限が必要です。
[開発] セクションから
[開発] セクションから [モデルを作成] ページにアクセスするには、次の操作を行います。
左側のナビゲーション パネルで [開発] をクリックします。
ナビゲーション パネルの [開発] セクションから、[プロジェクト] を選択します。
これを選択すると、[LookML プロジェクト] ページが開きます。[LookML プロジェクト] ページでは、アクセス権のあるすべてのプロジェクトと、それぞれのモデルを表示できます。[LookML プロジェクト] ページで [新しいモデル] ボタンを選択して、[モデルを作成する] ページを開きます。
[作成] ボタンから
[作成] ボタンから [モデルを作成] ページにアクセスするには、次の操作を行います。
- メイン ナビゲーション メニューで、[作成] ボタンをクリックします。
- プルダウン メニューから [LookML モデル] を選択します。[モデルを作成] ページが開きます。
モデルの生成
[モデルを作成] ページはセクションに分かれています。モデルを生成するには、次のセクションの手順を完了します。各セクションの入力が完了したら、[次へ] をクリックして入力内容を保存し、次のセクションに進みます。
データベース接続を選択:
- [データベース接続を選択]: プルダウン メニューからデータベース接続を選択します。プルダウン メニューから [Create New Connection] オプションを選択することもできます。[Connect your database to Looker] ページが表示されます。ここで、新しい接続を作成できます。
すでに接続を使用しているプロジェクトにアクセスできる場合は、接続を選択するとそのプロジェクトが表示されます。新しいモデルを既存のプロジェクトに追加することも、モデル用に新しい LookML プロジェクトを作成することもできます。
LookML プロジェクト名: モデルに新しい LookML プロジェクトを作成する場合は、このフィールドにプロジェクト名を入力します。プロジェクト名は、大文字と小文字が区別され、英数字、
_
、.
、-
のみを使用できます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。新しいプロジェクトは、ベア Git リポジトリを使用して構成されます。Looker が新しいプロジェクトに README ファイルを追加する場合は、[LookML の使用方法を詳細に説明する Readme ファイルを生成します] チェックボックスをオンにします。README ファイルには、LookML の概要とともに、新しい LookML 開発者に役立つリンクとリソースが含まれています。
[次へ] ボタンをクリックしてエントリを保存し、次のセクションに進みます。
テーブルを選択する:
- BigQuery 接続を使用している場合は、[GCP プロジェクトを選択] プルダウン メニューからデータセットが存在する Google Cloud プロジェクトを選択するか、[プロジェクト名を検索] フィールドでプロジェクトを検索します。デフォルトでは、Google Cloud ストレージ プロジェクトが存在する場合はプルダウン メニューに表示され、存在しない場合は Google Cloud 請求プロジェクトが表示されます。
- テーブルで、モデルで使用するデータセット(BigQuery)またはスキーマ(他の言語)を選択します。
- データセットまたはスキーマを選択したら、各データセットまたはスキーマ名の右側にある矢印を使用して [テーブル] タブを開き、含めるテーブルをそれぞれ選択します。テーブルからビューが作成されます。
- テーブルを選択したら、各テーブル名の右側にある矢印を使用して [フィールド] タブを開き、含める各フィールドを選択します。
- 接頭辞を無視: 生成されたビューファイル名のテーブル接頭辞を無視するには、このフィールドにデータベースの接頭辞をカンマ区切りのリストで入力します。この項目では大文字と小文字が区別されます。複数の接頭辞をカンマで区切って一覧表示できます。たとえば、テーブル名は
dwh_orders
とDBS_users
と名付けます。[Ignore Prefixes] フィールドに「dwh, DBS
」と入力すると、次に Looker によってorders
とusers
という名前のビューファイルが作成されます。 - フィールドの説明をインポートする: このチェックボックスをオンにして、データベース内の使用可能なフィールドの説明を、生成されたディメンションの LookML の説明として使用します。
- [次へ] ボタンをクリックしてエントリを保存し、次のセクションに進みます。
主キーを選択する:
- 選択した各テーブルの主キーを選択します。これにより、Looker はテーブルをより適切に結合できます。
- この手順は省略可能です。省略するには、主キーを選択しないでください。
- [次へ] ボタンをクリックしてエントリを保存し、次のセクションに進みます。
作成する Explore を選択する:
- Explore のベースビューとして使用する各ビューを選択します。選択した各ビューについて、システムは可能な限り多くの他のビューを自動的に結合します。結合で使用できるのは、前の手順で特定した主キーを持つビューのみです。
- この手順は省略可能です。スキップするには、ビューを選択しないでください。
- [次へ] ボタンをクリックしてエントリを保存し、次のセクションに進みます。
モデル名を入力:
- [モデル名] フィールドに、ファイルに付ける名前を入力します。重複するモデル名は使用できません。モデル名はケースセンシティブであり、スペースや特定の特殊文字は使用できません。
次のいずれかのボタンをクリックして、モデルファイルを生成し、選択した場合は新しいプロジェクトを生成します。
- モデルを完成させて表示: Looker IDE のファイルに移動します。
- データを完成させて探索する: [作成する Explore を選択] セクションで最初に選択したビューファイルに対応する Explore に移動します。
新しいプロジェクトを作成して、Looker がプロジェクトの作成に使用したベア Git リポジトリとは異なるリポジトリに接続する場合は、プロジェクトの [プロジェクト設定ページ] の [構成] タブで [Git 接続のリセット] ボタンをクリックして、プロセスを完了します。
モデルを構成する必要がある場合
モデルの構成は、次の理由で役立ちます。
- 所与のモデル名が特定のプロジェクト内の特定のモデルを参照するように指定します。
- モデルが使用を許可される接続を設定します。
Development Mode にある間は、管理者(または manage_models
権限または manage_project_models
権限を持つデベロッパー)はモデル構成が不要です。これにより、LookML デベロッパーは Development Mode にある間も作業を行えるようになります。ただし、モデル構成が存在する場合は、Development Mode であってもその構成によってクエリが制限されます。
LookML のデベロッパーはモデルファイルで目的の接続を指定しますが、管理者は [LookML プロジェクト] のページで許可される接続を制御します。モデルの構成で許可されていない接続の使用をモデルが指定する場合、接続は許可されません。
次のシナリオでは、モデルに構成が必要です。
- モデルが初めて本番環境に push されるとき。モデルが構成されていない場合、モデルが本番環境モードになると、そのモデル対するクエリはすべて失敗します。モデルが Development Mode から本番環境に初めて push される際に、モデルの名前が Looker インスタンスに対して一意である場合には、Looker がモデルを自動的に構成します。ただし、別のプロジェクトで同じ名前の構成済みのモデルがある場合、Looker はモデルを自動的に構成しません。
- 開発中。
manage_models
権限(admin
ロールに含まれる)またはmanage_project_models
権限が付与されていないデベロッパーがいる場合は、そうしたデベロッパーがそのモデルに対してクエリを実行する前に、モデルを構成する必要があります。モデルが存在する前か、プロジェクトが存在する前に、そのモデルを構成できます。次に、LookML デベロッパーがモデルを作成する際に、モデルの許可済みの接続がすでに構成されていて、デベロッパーはクエリを正常に実行できます。
Looker によって、manage_models
権限または manage_project_models
権限を持つデベロッパーは Development Mode で未構成のモデルでクエリを実行できます。Looker はモデルをその名前で検索して、これを行います。その名前で最初に見つかったモデルをクエリの実行に使用します。
計画モデルの構成
[LookML プロジェクト] ページの上部にある [新しいモデルを構成] ボタンを使用すると、Looker 管理者は既存のモデルまたはまだ存在しない予定のモデルの構成を追加できます。
事前にモデルを構成しておくと、デベロッパーに manage_models
権限または manage_project_models
権限が付与されていない場合に役立ちます。管理者がデベロッパー用にモデルを構成すると、デベロッパーはモデルファイルを生成または作成するとすぐにクエリを実行できるようになります。
管理者は、モデルで使用できるデータベース接続を指定することも、今後任意の接続をモデルで使用できるように指定することもできます。Looker デベロッパーは、LookML の connection
パラメータを使用して、モデルで使用する接続をモデルファイルで指定します。デベロッパーがモデルの構成で管理者が許可していない接続を指定した場合、そのモデルに対するクエリは実行されません。
管理者が事前に新しいモデルを構成し、その構成の一部として新しいプロジェクトを作成すると、そのプロジェクトは [プロジェクト] ページの [保留中のプロジェクト] セクションに表示されます。
空のプロジェクトを生成する
空のプロジェクトを作成すると、LookML ファイルをゼロから作成できます。
[モデルを作成] ページでは、LookML ファイルを含むプロジェクトが生成されます。ただし、[モデルを作成] ページで次のセクションのみを入力すると、生成される LookML ファイルを最小限に抑えることができます。
- データベース接続を選択する
- テーブルを選択する
- モデル名を入力してください
残りのセクションは未完成のままにします。
[Complete and View Model] ボタンをクリックすると、Looker IDE のプロジェクトに移動します。IDE で、不要な LookML ファイルを削除して、空のプロジェクトを作成できます。
次のステップ
モデルまたはプロジェクトを作成したら、次の操作を行うことができます。
- プロジェクトに新しいモデルを手動で作成する
- Looker IDE を使用して既存の LookML ファイルを編集する
- プロジェクトの名前を変更する
- Looker プロジェクトを Git に接続する