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