新しい LookML プロジェクトの作成

プロジェクトは、データベーステーブルがどのように相互に関係しているか、またLookerがそれらのテーブルをどのように解釈するかを規定するLookMLファイルのコレクションで形成されています。プロジェクトの詳細については、LookML のプロジェクトと開発モデルおよび LookML の用語とコンセプトに関するドキュメント ページをご覧ください。既存のプロジェクトへのアクセスと編集の詳細については、プロジェクト情報へのアクセスと編集のドキュメント ページをご覧ください。

1 つの LookML プロジェクトに、複数のモデルファイルを含めることができます。ただし、特定のモデルファイルに関しての LookML を表示および編集するためのユーザーの権限を指定したい場合は、新しいプロジェクトを作成することをおすすめします。Looker のほとんどの権限はモデルレベルで適用されますが、プロジェクトの LookML を確認できる see_lookml や、LookML を編集できる develop など、プロジェクト レベルに適用される権限もあります。

manage_models 権限を持つ Looker ユーザーは、Looker インスタンスで LookML モデルを作成できます。

プロジェクトの作成

プロジェクトを作成するには、次の手順を行います。

  1. Development Mode になっていることを確認します。

  2. ナビゲーション パネルの [開発] セクションから、[プロジェクト] を選択します。

  3. [LookML プロジェクト] ページで、[新しい LookML プロジェクト] を選択して、プロジェクトのオプションを選択します。

この操作を行うと、[新しいプロジェクト] ページが開き、プロジェクトの名前や開始点など、プロジェクトの設定を指定できます。

Looker はさまざまな方法でプロジェクトを作成できます。行う手順は、[新しいプロジェクト] ページで選択した [開始点] オプションによって異なります。以下のセクションでは、これらの開始点の仕組みについて説明します。

データベースからモデルを自動的に生成する

[新しいプロジェクト] ページで、次のオプションを指定してデータベースからモデルを自動的に生成します。

  1. プロジェクト名: プロジェクトの名前を入力します。プロジェクト名は、大文字と小文字が区別され、英数字、_、.、- のみを使用できます。Looker では次のような形でプロジェクト名が使用されます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。

    • project_id パラメータのある API 呼び出しのためにプロジェクトを識別する。
    • Looker インスタンスの内部データベースでプロジェクトを識別する。
    • ローカル プロジェクトのインポート用にプロジェクトを識別する。
    • [LookML プロジェクト] ページにプロジェクトを表示する。
    • Looker ナビゲーション パネルの [Develop] セクションにプロジェクトを表示する。
    • プロジェクト ファイルの URL の一部。たとえば、URL が example.looker.com の Looker インスタンスの場合、ecommerce という名前のプロジェクトのプロジェクト マニフェスト ファイルは、URL https://example.looker.com/projects/ecommerce/files/manifest.lkml で見つけることができます。

  2. 開始点: [Generate Model from Database Schema] を選択します。

  3. 接続: プルダウン メニューから、データベース接続の名前を選択します。

  4. ビューの作成元: 次のいずれかのオプションを選択します。

    • All Tables: LookML 生成ツールで、データベース内の各テーブルのビューファイルを作成します。
    • Single Table: LookML 生成ツールで、データベース内に 1 つのテーブルのビューを作成します。このオプションを選択した場合は、データベース テーブルの名前を入力します。

  5. スキーマ: データベース内の 1 つのスキーマのみのファイルを生成するには、[スキーマ] テキスト フィールドにスキーマの名前を入力します。複数のスキーマをカンマで区切って一覧表示できます。

  6. 接頭辞を無視する: ビューのファイル名からテーブル接頭辞を除外するには、[接頭辞を無視する] フィールドにデータベースの接頭辞を入力します。この項目では大文字と小文字が区別されます。複数の接頭辞をカンマで区切って一覧表示できます。たとえば、テーブル名は dwh_orders と DBS_users と名付けます。[Ignore Prefixes] テキスト フィールドに「dwh, DBS」と入力すると、次に Looker によって orders と users という名前のビューファイルが作成されます。

最後に、[Create Project] をクリックして、生成されたモデルを含むプロジェクトを作成します。

  • LookML 生成ツールは、特に指定のない限り、プロジェクト用に 1 つのモデルファイルを作成し、データベース内の各テーブルにビューファイルを作成します。その後、Looker によって Looker IDE で新しいプロジェクトが開かれます。
  • LookML 生成ツールによって、ビューファイルとモデルファイル用の IDE フォルダが作成されます。データベースに複数のスキーマがある場合、LookML 生成ツールはスキーマ用のフォルダを作成します。

BigQuery 接続の場合、データベースから LookML プロジェクトを生成すると、Looker によって BigQuery 列メタデータの説明から（ある場合）フィールドの説明が自動的に入力されます。

また、生成ツールはデータベース テーブルごとに Explore も作成します。データのクエリを開始するには、[Explore] パネルを使用して Explore の名前を選択します。

公開 Git リポジトリのクローンを作成する

開始点として [Clone Public Git Repository] を選択した場合、Looker は公開 Git リポジトリから新しい LookML プロジェクトにファイルをコピーします。

公開 Git リポジトリからクローン作成された Looker プロジェクトは読み取り専用です。ただし、読み取り専用プロジェクトを別の Looker プロジェクトにインポートして、そこでファイルを編集できます。また、複製したリポジトリ ファイルを開始点として使用し、Looker の extends パラメータまたは絞り込みを使用して、そこからプロジェクトを構築することもできます。

[新しいプロジェクト] ページで、次のオプションを指定して、既存の公開 Git リポジトリを Looker プロジェクトにクローンを作成します。

  1. プロジェクト名: プロジェクトの名前を入力します。プロジェクト名はケースセンシティブであり、スペースや特定の特殊文字は使用できません。Looker では次のような形でプロジェクト名が使用されます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。

    • project_id パラメータのある API 呼び出しのためにプロジェクトを識別する。
    • Looker インスタンスの内部データベースでプロジェクトを識別する。
    • ローカル プロジェクトのインポート用にプロジェクトを識別する。
    • [LookML プロジェクト] ページにプロジェクトを表示する。
    • Looker ナビゲーション パネルの [Develop] セクションにプロジェクトを表示する。
    • プロジェクト ファイルの URL の一部。たとえば、URL が example.looker.com の Looker インスタンスの場合、ecommerce という名前のプロジェクトのプロジェクト マニフェスト ファイルは、URL https://example.looker.com/projects/ecommerce/files/manifest.lkml で見つけることができます。

  2. [開始点]: [Clone Public Git Repository] を選択します。

  3. Git リポジトリの URL: 公開 Git リポジトリの URL を入力します。URL が git://github.com/example/my-repository.git の形式であることを確認します。

    https://github.com/llooker/blocks_redshift_admin などの URL を使用する場合は、正しい形式を使用するように編集するために、「https://」を「git://」に置き換えてから、語尾に「.git」を追加します。入力する URL は git://github.com/llooker/blocks_redshift_admin.git です。

最後に [プロジェクトを作成] をクリックします。Looker がすべての公開リポジトリのファイルを新しい LookML プロジェクトに pull し、Looker IDE でプロジェクトを開きます。

空のプロジェクトを作成する

開始点として [空のプロジェクト] を選択すると、Looker は空のプロジェクトを作成して、LookML ファイルをゼロから作成できるようにします。

[新しいプロジェクト] ページで、次のオプションを指定して空のプロジェクトを作成します。

  1. プロジェクト名: プロジェクトの名前を入力します。プロジェクト名には大文字と小文字の区別があり、スペースや特定の特殊文字は使用できません。Looker では次のような形でプロジェクト名が使用されます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。

    • project_id パラメータのある API 呼び出しのためにプロジェクトを識別する。
    • Looker インスタンスの内部データベースでプロジェクトを識別する。
    • ローカル プロジェクトのインポート用にプロジェクトを識別する。
    • [LookML プロジェクト] ページにプロジェクトを表示する。
    • Looker ナビゲーション パネルの [Develop] セクションにプロジェクトを表示する。
    • プロジェクト ファイルの URL の一部。たとえば、URL が example.looker.com の Looker インスタンスの場合、ecommerce という名前のプロジェクトのプロジェクト マニフェスト ファイルは、URL https://example.looker.com/projects/ecommerce/files/manifest.lkml で見つけることができます。

  2. 開始点: [空のプロジェクト] を選択します。

最後に [プロジェクトを作成] をクリックします。Looker でプロジェクトが作成され、Looker IDE で開きます。

次のステップ

プロジェクトを作成すると、次のことができます。