Metadata for LookML objects

Users who have develop permission can view contextually relevant information about the objects in the Looker IDE metadata panel.

To view the metadata panel in the Looker IDE:

  1. Navigate to your project files.
  2. Select the Quick Help icon to open the quick help panel.
  3. In the center panel, place your cursor on the object that you want to see in the metadata panel.
  4. Select the Metadata tab to open the metadata panel.

The metadata panel identifies the object with a name and an icon that represents the object type (see the Navigating projects with the object browser panel documentation page for all the possible object type icons).

For LookML objects that are used in multiple models, the metadata panel will provide a drop-down menu so you can select the model for which you want to see metadata.

The information displayed in the metadata panel depends on the type of LookML object selected and how the object is used in your project. You can use metadata to better understand many aspects of your project, as described in the following sections.

Metadata for models

If you click in a model file, the metadata shows you the Explores, views, and LookML dashboards that are included in the model, and provides links to where they are defined.

Metadata for views

If you select a view parameter, the metadata panel shows you the following information about how the view is used in your project:

  1. The view name and an icon that represents its object type (see the Navigating projects with the object browser panel documentation page for all the possible object type icons). The metadata panel also provides the filename and the line number where the view is defined in the file's LookML (and a link to the view in your project).
  2. Models that include this view.
  3. The view's primary key.
  4. Explores that use this view as their base view.
  5. Explores into which this view is joined.

If the view has extensions or refinements, these will also be displayed in the metadata panel.

Metadata for Explores

If you select an explore parameter, the metadata panel shows you the following information about how the Explore is used in your project:

  1. The Explore name and an icon that represents its object type (see the Navigating projects with the object browser panel documentation page for all the possible object type icons). The metadata panel also provides the filename and the line number where the Explore is defined in the file's LookML (and a link to the Explore in your project).
  2. The Explore's base view (the view used as the starting point for building the Explore).
  3. Other views that are joined into the base view.

If the Explore has extensions or refinements, these will also be displayed in the metadata panel.

Metadata for fields

If you select a field, the metadata panel shows you the following information about how the field is used in your project:

  1. The field name and an icon that represents its object type (see the Navigating projects with the object browser panel documentation page for all the possible object type icons). The metadata panel also shows the field's type and provides the filename and the line number where the field is defined in the file's LookML (and a link to the field in your project).
  2. Models that include this field's view.
  3. Views that use this field.

Metadata for extensions

When you select a view or an explore parameter, the metadata panel shows the object's extensions. Here is an example of an Explore that has been extended:

The metadata panel shows that the aircraft Explore is extended by the aircraft_extended Explore.

You can select the link in the Extended by section of the metadata panel to navigate directly to the LookML where the object is extended.

Similarly, you can use the metadata panel on extending objects to get contextual information about the extended object. As an example, the following sample LookML code is used in the definition of the aircraft_extended Explore to extend the aircraft Explore:


explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

In this case, the metadata panel provides information about the original extended object, such as which views are joined into the Explore and the name of the object it extends, which is the aircraft Explore in this example.

In these examples, the extending and extended explore parameters are next to each other in the same file, but this is not always the case. It's not obvious by looking a parameter if it is extended, especially since the extended and extending objects can be in different LookML files. The metadata panel gives you context about the related objects, no matter where the objects are defined.

Metadata for refinements

The metadata panel makes it easy to see when a view or an Explore has refinements that have been added to the object. The Refinements section of the metadata panel displays the number of refinements that have been added to the object, and you can use the links to navigate to the LookML for each refinement.

As with extensions, you can't tell if an object is refined just by looking at the LookML, especially because the refinement LookML can be in a different file. The metadata panel lets you see if an object has been refined, and lets you easily navigate to the LookML for the refinement.

Metadata for imported projects

The metadata panel includes information about objects from imported projects, including links to navigate to the imported file where the object is defined. For example, selecting the LookML for an Explore that is based on an imported view file will show the imported view file's information in the metadata panel.

The Base view section of the metadata panel shows information about the imported view.

From the metadata panel, you can select the link to navigate to the imported file where the object is defined.

In addition, you can click on objects in imported files to see metadata about the imported files.