Looker IDE にアクセスする最も簡単な方法は、Looker の [開発] メニューを使用することです。詳細とその他のオプションについては、プロジェクト ファイルへのアクセスをご覧ください。
Looker IDE ではプロジェクト ファイル用のフォルダをサポートします。フォルダが IDE の左側のナビゲーション パネルに表示されます。Looker デベロッパーがプロジェクト ファイルをフォルダに整理していない場合、プロジェクトはフラット ファイル構造となり、[ファイル ブラウザ] パネルにファイルがアルファベット順で表示されます。
デベロッパーが Explore、モデル、ビューなど、さまざまな種類のプロジェクト ファイル用のフォルダを追加したプロジェクトの例を次に示します。
[ファイル ブラウザ] パネルの上部にあるツールバーにあるアイコンを選択すると、すべてのフォルダを折りたたみ、ファイルやフォルダの移動や削除、プロジェクト ファイルの検索、新しいフォルダと新しいファイルの作成を行えます。
IDE サイドバーを閉じる
IDE のブラウザの表示と非表示を切り替えるには、キーボード ショートカットの Command-B(Mac)または Ctrl+B(Windows)を使用するか、ファイル ブラウザ アイコンを選択します。
ファイルとフォルダの管理
左側のパネルの各ファイルまたはフォルダには、そのアイテムに対して可能な操作を表示するメニューがあります。ファイル名の右側にある 3 点アイコンの [Folder Actions] メニュー(フォルダの場合)または [File Actions] メニュー(ファイルの場合)を選択してメニューを開きます。長い名前を持つアイテムや複数のフォルダにネストされているアイテムの場合は、左側のパネルでスクロールしてメニューにアクセスできます。
ファイル ブラウザを使用して、フォルダとファイルの作成、ファイルのアップロード、ファイルやフォルダの削除と移動を行うことができます。詳細については、LookML ファイルとフォルダの管理ドキュメント ページをご覧ください。
フォルダを使用して LookML ファイルを整理する場合は、他の Looker デベロッパーに表示される前に、変更を commit して本番環境にデプロイする必要があります。これは、LookML プロジェクトに加える変更と同様です。
インポートされたプロジェクト フォルダ
プロジェクトをインポートすると、Looker IDE によって自動的に imported_projects
フォルダが作成されます。ローカル プロジェクトとリモート プロジェクトの両方のファイルが imported_projects
フォルダで一覧表示されます。インポートしたプロジェクト ファイルを imported_projects
のファイルのリストから選択し、そのファイルの内容を表示します。
IDE でファイルを一括編集して、それらのファイルを移動または削除した場合、インポートされたプロジェクト ファイルは編集できないため、表示されません。
IDE フォルダを使用して既存のプロジェクトを整理
プロジェクトで従来のフラット ファイル構造を使用している場合や、フォルダ内のファイルを再編成する場合は、この構造を維持できますが、プロジェクト ファイルをフォルダに整理する場合は、次の準備を行うことを強くおすすめします。
- すべてのデベロッパーと事前にファイル構造を計画してください。
- すべての Looker デベロッパーがすべての更新を本番環境にデプロイしたことを確認します。デベロッパーが変更内容をデプロイ解除している場合、ブランチには、最後に本番環境から pull したときに存在していたファイル構造が反映されます。その時点でプロジェクトがフラット ファイル構造になっている場合は、デベロッパーのバージョンのファイルが元の場所に本番環境に push されるため、そのファイルの 2 つのコピーが作成されます。また、デベロッパーがフォルダへの移行中に変更をデプロイ解除している場合、移行後に本番環境から pull すると、そのマージの競合が発生します。
- プロジェクトが新しいディレクトリ構造に完全に移行されるまで、すべてのデベロッパーとともに一時的なコードフリーズを行います。
- 1 人のデベロッパーを割り当てて、ファイルを移動します。以下の手順では、1 人のデベロッパーがプロジェクトを IDE フォルダに移行することを前提としています。複数のデベロッパーがファイルを移動する必要がある場合は、マージの競合を回避するためにデベロッパー間でタスクを分割します。マージの競合が発生した場合は、バージョン管理機能の使用とデプロイのドキュメント ページでその解決方法を確認してください。
すべてのデベロッパーが変更を push して commit し、プロジェクトのすべての作業を一時停止したら、プロジェクトを新しいディレクトリ構造に移行できます。
次の手順をすべて行うには、1 人のデベロッパーを割り当てます。
- すべての開発ブランチのすべての更新が本番環境にデプロイされていることを確認します。これには、IDE フォルダへの移行を実行するデベロッパーの開発ブランチが含まれます。
- 他のすべてのデベロッパーがプロジェクトへの変更を停止していることを確認します。
- Pull from production。
- プロジェクトのフォルダを作成します。
- プロジェクト ファイルを一度に 1 ファイル、または一括編集を使用してフォルダに移動します。
- プロジェクトの LookML を検証します。この手順では
include
ファイルとmap_layer
ステートメントを使用して移動した可能性があるファイルの場所を参照するため、LookML エラーと警告が複数発生することが予想されます。 ファイルの新しいパスに合わせて、プロジェクト内の
include
ステートメントとmap_layer
ステートメントを更新します。また、ファイルパスが変更されたことで見つからなくなった参照先オブジェクトに対する LookML 検証エラーが表示される場合があります。詳細については、IDE フォルダでのinclude
の使用と IDE フォルダでのmap_layer
の使用をご覧ください。他の Looker デベロッパーに、更新を本番環境から pull して、プロジェクトでの開発を再開できることを知らせます。