プロジェクトは、データベーステーブルがどのように相互に関係しているか、またLookerがそれらのテーブルをどのように解釈するかを規定するLookMLファイルのコレクションで形成されています。プロジェクトの詳細については、LookML のプロジェクトと開発モデルおよび LookML の用語とコンセプトに関するドキュメント ページをご覧ください。既存のプロジェクトへのアクセスと編集の詳細については、プロジェクト情報へのアクセスと編集のドキュメント ページをご覧ください。
1 つの LookML プロジェクトに、複数のモデルファイルを含めることができます。ただし、特定のモデルファイルに関しての LookML を表示および編集するためのユーザーの権限を指定したい場合は、新しいプロジェクトを作成することをおすすめします。Looker のほとんどの権限はモデルレベルで適用されますが、プロジェクトの LookML を確認できる see_lookml
や、LookML を編集できる develop
など、プロジェクト レベルに適用される権限もあります。ユーザーに 1 つのモデルへのアクセス権を付与するが、別のモデルにはアクセスさせたくない場合は、ユーザーにアクセスさせたくないモデルを含む別のプロジェクトを作成することをおすすめします。
manage_models
権限を持つ Looker ユーザーは、Looker インスタンスで LookML モデルを作成できます。
プロジェクトの作成
プロジェクトを作成するには、次の手順を行います。
ナビゲーション パネルの [開発] セクションから、[プロジェクト] を選択します。
[LookML プロジェクト] ページで、[新しい LookML プロジェクト] を選択して、プロジェクトのオプションを選択します。
この操作を行うと、[新しいプロジェクト] ページが開き、プロジェクトの名前や開始点など、プロジェクトの設定を指定できます。
Looker はさまざまな方法でプロジェクトを作成できます。行う手順は、[新しいプロジェクト] ページで選択した [開始点] オプションによって異なります。以下のセクションでは、これらの開始点の仕組みについて説明します。
データベースからモデルを自動的に生成する
開始点として [Generate Model from Database Schema] を選択すると、LookML 生成ツールでモデルが自動的に作成され、データベースのテーブルに基づいてプロジェクト ファイルが表示されます。詳細については、モデルの生成のドキュメント ページをご覧ください。
このオプションの場合、Looker はデータベースに基づいて LookML を自動的に生成できるように接続名を要求します。ただし、後から接続を追加することもできます。
公開 Git リポジトリのクローンを作成する
開始点として [Clone Public Git Repository] を選択した場合、Looker は公開 Git リポジトリから新しい LookML プロジェクトにファイルをコピーします。
公開 Git リポジトリからクローン作成された Looker プロジェクトは読み取り専用です。ただし、読み取り専用プロジェクトを別の Looker プロジェクトにインポートして、そこでファイルを編集できます。また、複製したリポジトリ ファイルを開始点として使用し、Looker の extends
パラメータまたは絞り込みを使用して、そこからプロジェクトを構築することもできます。
Looker プロジェクトに既存のパブリック Git リポジトリのクローンを作成するには:
- Development Mode になっていることを確認します。
- [開発] メニューから [LookML プロジェクトの管理] を選択します。
[LookML プロジェクト] ページで、[新しい LookML プロジェクト] を選択して [新しいプロジェクト] ページを開きます。
[新しいプロジェクト] ページで、プロジェクトのオプションを指定します。
プロジェクト名: プロジェクトの名前を入力します。Looker では次のような形でプロジェクト名が使用されます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。
project_id
パラメータのある API 呼び出しのためにプロジェクトを識別する。- Looker インスタンスの内部データベースでプロジェクトを識別する。
- ローカル プロジェクトのインポート用にプロジェクトを識別する。
- [LookML プロジェクト] ページにプロジェクトを表示する。
- Looker ナビゲーション パネルの [Develop] セクションにプロジェクトを表示する。
- プロジェクト ファイルの URL の一部。たとえば、URL が
example.looker.com
の Looker インスタンスの場合、ecommerce
という名前のプロジェクトのプロジェクト マニフェスト ファイルは、URLhttps://example.looker.com/projects/ecommerce/files/manifest.lkml
で見つけることができます。
[開始点]: [Clone Public Git Repository] を選択します。
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 ファイルをゼロから作成できるようにします。
空のプロジェクトを作成するには:
- Development Mode になっていることを確認します。
- [開発] メニューから [LookML プロジェクトの管理] を選択します。
[LookML プロジェクト] ページで、[新しい LookML プロジェクト] を選択して [新しいプロジェクト] ページを開きます。
[新しいプロジェクト] ページで、プロジェクトのオプションを指定します。
プロジェクト名: プロジェクトの名前を入力します。Looker では次のような形でプロジェクト名が使用されます。プロジェクト名は慎重に選択してください。また、プロジェクトの名前はプロジェクトの永続的な ID になると考えてください。
project_id
パラメータのある API 呼び出しのためにプロジェクトを識別する。- Looker インスタンスの内部データベースでプロジェクトを識別する。
- ローカル プロジェクトのインポート用にプロジェクトを識別する。
- [LookML プロジェクト] ページにプロジェクトを表示する。
- Looker ナビゲーション パネルの [Develop] セクションにプロジェクトを表示する。
- プロジェクト ファイルの URL の一部。たとえば、URL が
example.looker.com
の Looker インスタンスの場合、ecommerce
という名前のプロジェクトのプロジェクト マニフェスト ファイルは、URLhttps://example.looker.com/projects/ecommerce/files/manifest.lkml
で見つけることができます。
開始点: [空のプロジェクト] を選択します。
[プロジェクトを作成] を選択します。Looker でプロジェクトが作成され、Looker IDE で開きます。
空のプロジェクトを作成したら、model ファイルと view ファイルを作成し、プロジェクトを Git に接続して、LookML ファイルの変更を記録し、ファイルのバージョンを確認できるようにします。
モデルを構成する
[LookML プロジェクト] ページの上部にある [新しいモデルを構成] ボタンを使用して、既存または計画中のモデルの構成を追加します。
まだプロジェクトが存在しない場合のモデルの構成は、モデルの生成ドキュメント ページで説明されているように、デベロッパーに manage_models
権限または manage_project_models
権限が付与されていない場合に役立ちます。デベロッパー用にモデルを構成すると、デベロッパーはモデルファイルを生成または作成するとすぐにクエリを実行できるようになります。構成のみを含むプロジェクトの詳細については、プロジェクト情報へのアクセスと編集ドキュメント ページをご覧ください。
モデルで使用できるデータベース接続を指定することも、今後任意の接続をモデルで使用できるように指定することもできます。Looker デベロッパーは、LookML の connection
パラメータを使用して、モデルで使用する接続をモデルファイルで指定します。デベロッパーがモデルの構成で許可されていない接続を指定した場合、そのモデルに対するクエリは実行されません。