このページでは、新しいプロジェクトを作成し、データベースから基本モデルを自動的に生成する手順を説明します。
プロジェクト ファイルを作成するには、ほかにも方法があります。空のプロジェクトを作成してモデルを手動で作成するか、既存の公開 Git リポジトリのクローンを作成します。新しい LookML プロジェクトの作成に関するドキュメント ページをご覧ください。
データベースからモデルを自動的に生成する
メニューバーで [Develop] をクリックし、開発モードになっていることを確認します。
[Develop]（開発）メニューから [Projects]（プロジェクト）を選択します。
[LookML Projects] ページで、[New LookML Project] をクリックします。
- LookML プロジェクト ページでは、すべてのプロジェクトとそれぞれのモデルを確認できます。このページでは、プロジェクトの作成、表示、構成を行います。
[New Project] ダイアログで、プロジェクトのオプションを指定します。
- プロジェクトの名前を指定します。
- [Starting Point] で、[Generate Model from Database Schema] を選択します。
- [接続] プルダウン メニューから、データベース接続の名前を選択します。
- [Build Views From] で、次のいずれかのオプションを選択します。
- すべてのテーブル: LookML 生成ツールは、データベース内のテーブルごとにビューファイルを作成します。
- 単一テーブル: LookML 生成ツールは、データベース内の 1 つのテーブルのビューを作成します。このオプションを選択した場合は、データベース テーブルの名前を入力します。
- データベース内の 1 つのスキーマ専用のファイルを生成するには、[スキーマ] テキスト フィールドにスキーマ名を入力します。複数のスキーマは、カンマで区切って指定できます。
- ビュー接頭辞にテーブルの接頭辞を含めないようにするには、[接頭辞を無視する] テキスト フィールドにデータベースの接頭辞を入力します。このフィールドでは大文字と小文字が区別されます。複数の接頭辞を指定する場合は、カンマで区切ります。たとえば、テーブルのタイトルが
dwh_ordersとDBS_usersの場合、[Ignore Prefixes] テキスト フィールドに「dwh, DBS」と入力すると、ordersとusersという名前のビューファイルが作成されます。
[プロジェクトを作成] をクリックします。
- LookML 生成ツールは、プロジェクト用に 1 つのモデルファイルを作成し、データベース内のテーブルごとにビューファイルを作成します（特に指定のない限り）。その後、新しいプロジェクトが Looker IDE で開きます。
- LookML 生成ツールは、ビューファイルとモデルファイルの IDE フォルダを作成します。データベースに複数のスキーマがある場合、LookML 生成ツールはスキーマ用のフォルダを作成します。
BigQuery 接続の場合、データベースから LookML プロジェクトを生成すると、Looker ではフィールドの説明が BigQuery 列メタデータ（存在する場合）から自動的に入力されます。
また、データベース テーブルごとに Explore も作成されます。データのクエリを開始するには、[Explore] メニューを使用して Explore の名前を選択します。管理者が拡張ナビゲーションの Labs 機能を有効にしている場合は、新しい拡張左側のナビゲーション パネルからデータ探索オプションを選択します。詳細については、Looker でのデータ探索に関するドキュメント ページをご覧ください。
作成後にプロジェクト名を変更するには、ドキュメント情報ページのプロジェクト情報にアクセスして編集するのプロジェクト名の変更をご覧ください。
モデルとビューファイルについてのドキュメント ページで説明されているように、プロジェクト向けに新しいモデルを手作業で作成できます。また、このページのモデルの構成が必要な場合のセクションで説明しているとおり、本番環境で使用するようにモデルを設定してください。また、新しい LookML プロジェクトの作成に関するドキュメント ページで詳細をご確認ください。
モデルファイルを生成または手動で作成したら、Git 接続の設定とテストのドキュメントで、Looker プロジェクトを Git に接続する方法を確認してください。LookML ファイルの変更を記録し、ファイルの版を管理できます。
LookML 生成の改善
Looker 管理者が LookML 生成機能の改善に関する Labs 機能を有効にしている場合、データベースからプロジェクトを生成するときに、Looker によってプロジェクトに要素が追加されます。
- Looker により、新しいプロジェクトに README ファイルが追加されます。README ファイルには、LookML の概要に加え、新しい LookML デベロッパー向けのリンクとリソースが含まれています。
- Looker は、モデルファイルと各ビューファイルにインライン コメントの複数の説明を追加します。
- ビューに、名前に文字列
idを含まないtype: numberのディメンションが 1 つ以上ある場合、Looker のメジャーとtype: averageのメジャーが作成されます。どちらも、名前に文字列idを含まないアルファベット順の最初のディメンションtype: numberに基づいています。
モデルの構成が必要な場合
モデルの構成は、次のような理由から便利です。
- 特定のモデル名が特定のプロジェクト内の特定のモデルを参照するように指定します。
- モデルで使用できる接続を設定します。
開発モードになっている間は、管理者（または manage_models 権限を持つデベロッパー）がモデル設定を行う必要はありません。これにより、LookML デベロッパーは開発モードで簡単に作業できます。ただし、モデル構成が存在する場合、開発モードであっても、クエリはその構成によって制約されます。
LookML デベロッパーはモデルファイルで目的の接続を指定していますが、LookML プロジェクト ページで許可する接続は管理者が制御します。モデルの構成で許可されていない接続をモデルが使用している場合、その接続は許可されません。
次のシナリオでは、モデルに構成が必要です。
- モデルが初めて本番環境に push されたときモデルが構成されていない場合、そのモデルが本番環境モードになると、そのモデルに対するクエリは失敗します。モデルが開発モードから本番環境に初めて push されるときに、モデル名が Looker インスタンスに固有のものである場合、Looker はモデルを自動的に構成します。ただし、別のプロジェクトで同じ名前のモデルが構成されている場合、Looker で自動的にモデルを構成することはありません。
- 開発中。
manage_models権限（adminロールに含まれる権限）が付与されていないデベロッパーの場合は、そのモデルに対するクエリを実行する前に、モデルを構成する必要があります。モデルが存在する前、またはプロジェクトが存在する前にモデルを構成できます。その後、LookML デベロッパーがプロジェクトとモデルを作成すると、モデルで許可されている接続がすでに構成され、デベロッパーはクエリを正常に実行できるようになります。
manage_models権限のないデベロッパーの場合、管理者は特定のモデルセットにデベロッパーを限定し、そのモデルで許可される接続を制限することにより、特定の接続へのアクセスを制限できます。
Looker では、manage_models 権限を持つユーザーは開発モードで構成されていないモデルに対してクエリを実行できます。Looker では、プロジェクトを探してその名前のモデルを検索します。その名前で最初に見つかったモデルが、クエリの実行に使用されます。