A project in Looker is a collection of related 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. This page lists the types of files that can be present in a project, with a brief description and links to more information about each.
Where Do Projects and Files Come From?
When a new project is created, Looker’s project generator creates a baseline set of files:
- One view file for each table in your database
- One model file, which declares an Explore for each view
For more information about project generation, see the LookML Terms and Concepts and Creating a New LookML Project documentation pages.
A model file specifies a database connection and the set of Explores that should use that connection. This is where you’ll define which data tables should be used (as included views) and how they should be joined together, if necessary.
For more information on model files, see the Understanding Model and View Files and LookML Terms and Concepts documentation pages.
A view file specifies a table to query and the fields (dimensions and measures) to include from that table.
For more information on view files, see the Understanding Model and View Files and LookML Terms and Concepts documentation pages.
Looker supports both user-defined dashboards and dashboards that are built directly into your project using LookML. If your project contains LookML dashboards, they will be defined in dedicated dashboard files.
For more information on LookML dashboards, see the Creating LookML Dashboards documentation page.
In Looker, you can use TopoJSON files to specify custom maps for your visualizations. If your project contains TopoJSON-based custom maps, they will be defined in dedicated files in your project’s data section.
For more information on using data files for custom mapping, see the Map Options and map_layer LookML parameter documentation pages.
You can write documentation and other notes about your project using GitHub-flavored markdown in one or more documentation files.
For more information, see Documentation Files on the Understanding Other Project Files documentation page.
Your project may contain a project manifest file that lists files from other projects to import into the current project, or may contain customized localization settings.
To have the option of adding a manifest file, the Looker admin must enable the Project Import experimental Labs feature.
Locale Strings Files
If you are localizing your project, it may contain files with translation strings corresponding to different languages.
For more information, see the Model Localization documentation page.
Your project may also contain other files whose filetypes are not recognized by Looker’s IDE as belonging to one of the categories above.
For more information on filetypes that are likely to be stored in the Other category, and on moving files from the Other category, see the Understanding Other Project Files documentation page.
Accessing Project Files
To view existing projects on the LookML Projects page, click the Develop menu and choose Manage LookML Projects.
The projects you see in those lists depend on the following things:
- Your Permissions: The projects and models you see on the Develop menu and the LookML Projects page depend on your permissions.
- Your Current Mode: You may see additional entries on the Develop menu and the LookML Projects page when you view them in Development Mode versus Production Mode. For example, if you created a new model in Development Mode that you have not yet pushed to production, then that model would be visible only when you are in Development Mode.
For more information, see the Accessing and Editing Project Information documentation page.