home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
remote_dependency

Usage

remote_dependency: public_project {
  url: "https://github.com/llooker/google_ga360"
  ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}

Hierarchy

remote_dependency

Default Value

None

Accepts

  • A url subparameter that includes the URL of the Git repository
  • A ref subparameter that specifies a Git branch, a Git release tag, or the SHA of a commit in the Git repository
  • An override_constant subparameter, which is used to override the value of a constant imported from another project

Definition

The remote_dependency parameter provides the details of an external Git repository containing a LookML project that has files that you want to use in this project. You can include multiple remote_dependency statements in the manifest file to import multiple projects.

The remote_dependency parameter goes in your project’s manifest file. If your project doesn’t have one, you can create a manifest file.

The remote_dependency parameter takes a name, which can be anything you like. This name is what you use in include statements to reference the imported files in LookML projects. The name is also used as the folder name under the imported_projects folder of the Looker IDE.

In addition, the remote_dependency parameter has the following subparameters:

url

The url subparameter specifies the address of the external Git repository. Use the main URL of the repository. For example, using HTTPS:

url: "https://github.com/llooker/google_ga360"

Or using SSH:

url: "git@github.com:llooker/google_ga360.git"

ref

The ref subparameter specifies a Git branch, a Git release tag, or a commit SHA of the remote project’s Git repository that Looker should bring into your Looker project:

Here is an example remote dependency that specifies a commit SHA from the remote Git project:

remote_dependency: ga_360 { url: "https://github.com/llooker/google_ga360" ref: "f99720c597f524d0756b8194990342efa11b3813" }

Here is an example remote dependency that specifies the master branch on the remote Git project:

remote_dependency: ga_360 { url: "https://github.com/llooker/google_ga360" ref: "master" }

Regardless of the type of ref you specify, when you add a remote_dependency to your project and validate your LookML, the IDE will display the Update Dependencies button. Click the button to bring in the remote project files. If this is the first remote project you’ve added to your project, updating dependencies will also prompt Looker to create a manifest lock file. Looker uses the manifest lock file to track the version of the remote project(s). See the Automatically detecting new versions of a remote project section of the Importing files from other projects documentation page for more information.

override_constant

The override_constant parameter allows you to override the value of a constant that was defined in an imported project.

The override_constant parameter can also be used with the local_dependency parameter for local project import.

When importing files from one project into another, you can override the values of constants defined in the imported project’s manifest file. When you override a constant’s value, imported files that reference that constant will use the new value provided in the importing project.

When the export parameter is set to override_required or override_optional for a constant defined in the imported project, the override_constant subparameter of local_dependency can be used to provide a new value for that constant. For example, suppose you have a constant connection defined in the imported project’s manifest file:

constant: connection { value: "imported_project_connection" export: override_required }

In this example, because the export parameter is set to override_required, its value must be overridden in the importing project’s manifest file:

project_name: "importing_project" remote_dependency: public_project { url: "https://github.com/llooker/project" ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1" override_constant: connection { value: "importing_project_connection" } }

See the Importing files from other projects documentation page for more information and another example of overriding constants in importing projects.

Example

In a manifest file, add the “Google GA 360” Git repository as a source to import files from:

project_name: "thelook" remote_dependency: ga_360 { url: "https://github.com/llooker/google_ga360" ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03" }

Top