A Looker project is a collection of LookML files that tell Looker how to connect to your database, how to query your data, and how to control the user interface’s behavior.
Accessing Project Files
To view LookML files for a project, click the Develop menu and choose the name of the project:
The projects you see in Develop menu depend on the following:
- Your Permissions: To see a project, you must have the
developpermission for at least one model in the project.
- Your Current Mode: You may see additional entries on the Develop menu when you are in Development Mode versus Production Mode. For example, if you created a new project in Development Mode that you have not yet pushed to production, then that project would be visible in the menu only when you are in Development Mode.
Project File Types
A LookML project can have the following types of files. All project files have extensions, although the extensions are hidden in the IDE list if your project isn’t enabled for folders in the IDE.
Click the links to get more information about the file types:
- Model files with extension
- View files with extension
- Dashboard files with extension
- Data files with extension
- Document files with extension
- Project manifest files with extension
- Locale strings files with extension
- Explore files with extension
- Data test files with extension
- Other files with any file extension not listed above, such as dedicated files for refinements. If your project is not enabled for folders in the IDE, the IDE includes Explore files in the Other section.
You can automatically generate a model file and view files based on your database when you create a new project. For existing projects, you can create new files manually by clicking the + icon at the top of the project file list in the Looker IDE, or you can use a folder’s menu to create the file inside the folder.
Navigating to Files
When you open a LookML project, the Looker IDE opens the project to one of the LookML files in that project:
- If the project contains a document file named
readme.md, the IDE will open that file.
- If there’s no
readme.mddocument file, the IDE will open the first alphabetical document file.
- If there are no document files in the project, the IDE will open the first alphabetical model file.
- If there are no model files in the project, the IDE will open the first alphabetical file of any type.
To open a different project file, click on the filename in the side panel of the Looker IDE. If your project is enabled for folders in the IDE, LookML developers can customize the file organization to match your project. Here is an example project with folders for each file type:
If your project is not enabled for folders, the IDE organizes your files according to file type, like this:
You can show or hide the file navigation panel in the IDE using the keyboard shortcut Ctrl+B (Windows) or Command-B (Mac), or by clicking the arrow:
The navigation panel cannot be collapsed when the Project Settings page is displayed.
If your project has IDE folders enabled and your admin has enabled the Object Browser Labs feature, you can also use the object browser to view all the objects in your project or to navigate to the LookML for a specific object. To use the object browser, select the object browser icon below the folder icon in the Looker IDE:
For more information on the object browser, see the Navigating Projects with the Object Browser documentation page.