Looker IDE にアクセスする最も簡単な方法は、Looker の [Develop] メニューを使用することです。詳細とその他のオプションについては、プロジェクト ファイルへのアクセスをご覧ください。
Looker IDE ではプロジェクト ファイル用のフォルダをサポートします。フォルダは、IDE の左側のナビゲーション パネルに表示されます。Looker デベロッパーがプロジェクト ファイルをフォルダに整理していない場合、プロジェクトはフラットな構造となり、[File Browser] パネルにアルファベット順で表示されます。
次の例では、デベロッパーがさまざまなタイプのプロジェクト ファイル(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 して、プロジェクトでの開発を再開できることを知らせます。