新しい 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. 接頭辞を無視する: ビューのファイル名からテーブル接頭辞を除外するには、[Ignore Prefixes] フィールドにデータベースの接頭辞を入力します。この項目では大文字と小文字が区別されます。複数の接頭辞をカンマで区切って一覧表示できます。たとえば、テーブル名は 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 の名前を選択します。

[New Project] ページから公開 Git リポジトリのクローンを作成する

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

Looker では、リポジトリの HTTPS ウェブ URL を使用して公開 Git リポジトリのクローンを作成できます。

Looker プロジェクトに既存のパブリック Git リポジトリのクローンを作成するには、次の手順を行います。

  1. Development Mode になっていることを確認します。
  2. Looker ナビゲーション パネルの [開発] セクションから、[プロジェクト] を選択します。

  3. [LookML プロジェクト] ページで、インスタンスの構成に応じて、次のいずれかを行います。

    • [New LookML Project] ボタンをクリックして、[New Project] ページを開きます。
    • [新しいモデル] ボタンをクリックして [モデルを作成] ページを開き、[モデルを作成] ページの情報バナーで [こちらをクリック] リンクをクリックして [新しいプロジェクト] ページを開きます。

  4. [プロジェクト名] フィールドに、プロジェクトの名前を入力します。プロジェクト名では大文字と小文字が区別され、スペースや特定の特殊文字は使用できません。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 で見つけることができます。

  5. [開始点] フィールドで、[Clone Public Git Repository] を選択します。

  6. [Git リポジトリの URL] フィールドに、公開 Git リポジトリの URL を入力します。URL が https://github.com/example/my-repository.git の形式であることを確認します。

  7. [プロジェクトを作成] をクリックします。Looker はリポジトリのクローンを作成し、クローンされたリポジトリのプロジェクト ファイルを使用して、新しい LookML プロジェクトの Looker IDE を開きます。

Looker で新しい LookML プロジェクトを作成したら、Git リポジトリに接続して Git バージョン管理を設定する必要があります。HTTPS または SSH を使用して Git に接続する手順については、Git 接続の設定とテストのドキュメント ページをご覧ください。

状況に応じて、独自の Git リポジトリに変更を push するように Git 接続を設定することも、クローン元の Git リポジトリに変更を push することもできます。

  • クローン作成したファイルを、公開 Git リポジトリとは独立した独自のプロジェクトの開始点として使用する場合は、プロジェクトの Git 接続を設定して独自の Git リポジトリを指し、変更をそこに push します。
  • クローンを作成した公開 Git リポジトリに更新をコントリビュートし、公開リポジトリへの読み取り / 書き込みアクセス権を持つ個人アクセス トークンがある場合は、プロジェクトの Git 接続を公開 Git リポジトリを指すように設定し、変更をそこに push します。

リポジトリへの Git 接続を設定したら、Looker IDE でファイルを編集し、標準の LookML プロジェクトと同様にバージョン管理を使用して変更を本番環境にデプロイできます。

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

公開 Git リポジトリのクローンを作成する最も簡単な方法は、Looker の [New Project] ページを使用することです。

また、次の手順でリポジトリをフォークし、Looker の空のプロジェクトに接続することもできます。

  1. Git プロバイダに移動してリポジトリをフォークします。
  2. Looker で、このページの空のプロジェクトを作成するセクションの説明に沿って、空のプロジェクトを作成します。
  3. 新しい空の LookML プロジェクトを作成したら、HTTPS または SSH を使用して、プロジェクトの Git 接続を Git リポジトリ フォークに設定します。

リポジトリ フォークへの Git 接続を設定したら、Looker IDE でファイルを編集し、標準の LookML プロジェクトと同様にバージョン管理を使用して変更を本番環境にデプロイできます。

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

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

空のプロジェクトを作成する手順は次のとおりです。

  1. Development Mode になっていることを確認します。
  2. Looker ナビゲーション パネルの [開発] セクションから、[プロジェクト] を選択します。

  3. [LookML プロジェクト] ページで、インスタンスの構成に応じて、次のいずれかを行います。

    • [New LookML Project] ボタンをクリックして、[New Project] ページを開きます。
    • [新しいモデル] ボタンをクリックして [モデルを作成] ページを開き、[モデルを作成] ページの情報バナーで [こちらをクリック] リンクをクリックして [新しいプロジェクト] ページを開きます。

  4. [プロジェクト名] フィールドに、プロジェクトの名前を入力します。プロジェクト名では大文字と小文字が区別され、スペースや特定の特殊文字は使用できません。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 で見つけることができます。

  5. [開始点] フィールドで、[空のプロジェクト] を選択します。

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

「プロジェクトはすでに存在します」エラーのトラブルシューティング

Looker IDE で新しいプロジェクトを作成すると、プロジェクトが Looker UI に表示されない場合でも（管理者権限を持つユーザーを含む）、Project already exists エラーが発生することがあります。この問題は、ユーザーが以前に Development Mode で同じ名前のプロジェクトを作成したものの、モデルをデプロイしなかったか、変更を本番環境に push しなかった場合に発生します。Looker では、この未 commit 状態のプロジェクトは、作成したユーザーにのみ表示されます。

この問題を解決するには、プロジェクトの作成者を特定し、そのユーザーとしてプロジェクトを commit してデプロイするか、次のように削除します。プロジェクト作成者として sudo を実行するには、Looker 管理者であるか、sudo 権限を持っている必要があります。

1 プロジェクト作成者を特定する: プロジェクト名を使用してシステム アクティビティ Explore でクエリを実行し、プロジェクトを最初に作成したユーザーを特定します。1 作成者として sudo を実行する: Looker の sudo 機能を使用して、特定されたユーザーの権限を借用します。1 プロジェクトを管理または削除する: 作成者としてログインした状態で、Development Modeに切り替えます。プロジェクトが IDE に表示されます。プロジェクトを構成またはデプロイするか、プロジェクトを削除してプロジェクト名を解放できます。

次のステップ

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