Remote-Abhängigkeit

Nutzung

remote_dependency: public_project {
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcaccdcdc400f668fd8147f1"
Hierarchie
remote_dependency
Standardwert
Keine

Akzeptiert
  • Einen url-Unterparameter, der die URL des Git-Repositorys enthält
  • Ein ref-Unterparameter, der einen Git-Zweig, ein Git-Release-Tag oder das SHA eines Commits im Git-Repository angibt
  • Ein Unterparameter override_constant, mit dem der Wert einer Konstante überschrieben wird, die aus einem anderen Projekt importiert wurde

Definition

Der Parameter remote_dependency enthält die Details eines externen Git-Repositorys, das ein LookML-Projekt mit Dateien enthält, die Sie in diesem Projekt verwenden möchten. Sie können mehrere remote_dependency-Anweisungen in die Manifestdatei aufnehmen, um mehrere Projekte zu importieren.

Der Parameter remote_dependency wird in die Manifestdatei Ihres Projekts aufgenommen. Wenn für Ihr Projekt keine Datei vorhanden ist, können Sie eine Manifestdatei erstellen.

Der Parameter remote_dependency kann einen beliebigen Namen haben. Der Name kann beliebig sein. Sie verwenden diesen Namen in include-Anweisungen, um auf die importierten Dateien in LookML-Projekten zu verweisen. Der Name wird auch als Ordnername im Ordner imported_projects der Looker-IDE verwendet.

Darüber hinaus hat der Parameter remote_dependency die folgenden Unterparameter:

url

Der Unterparameter url gibt die Adresse des externen Git-Repositorys an. Verwenden Sie die Haupt-URL des Repositorys. Verwenden Sie beispielsweise HTTPS:

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

Oder mit SSH:

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

ref

Der Unterparameter ref gibt einen Git-Zweig, ein Git-Release-Tag oder ein Commit-SHA des Git-Repositorys des Remote-Projekts an, das Looker in Ihr Looker-Projekt bringen soll:

  • Git-Branch: Sie können einen Git-Zweig angeben, wenn Looker neue Commits für diesen Zweig automatisch aus dem Remoteprojekt erkennen soll. Weitere Informationen finden Sie auf der Dokumentationsseite zum Importieren von Dateien aus anderen Projekten.
  • Git-Release-Tag: Sie können ein Git-Release-Tag angeben, wenn Looker neue Commits für dieses Tag automatisch aus dem Remoteprojekt erkennen soll. Weitere Informationen finden Sie auf der Dokumentationsseite zum Importieren von Dateien aus anderen Projekten.
  • Commit-SHA: Sie können ein Commit-SHA angeben, wenn Sie eine statische Versionsverwaltung verwenden möchten, damit Änderungen im importierten Projekt nicht automatisch in Ihrem Projekt widergespiegelt werden. In der Regel ist dies das neueste Commit, das ist aber nicht unbedingt erforderlich. Commit-SHAs können Sie überall im Commit-Verlauf finden. Git-Dienstanbieter sorgen dafür, dass das SHA in der Regel deutlich sichtbar und kopierbar ist. Diese Option eignet sich gut für Looker Blocks.

Hier ist ein Beispiel für eine Remoteabhängigkeit, die ein Commit-SHA aus dem Remote-Git-Projekt angibt:

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

Hier ist ein Beispiel für eine Remoteabhängigkeit, die den Master-Branch des Git-Projekts angibt:

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

Unabhängig vom angegebenen ref-Typ wird in der IDE die Schaltfläche Abhängigkeiten aktualisieren angezeigt, wenn Sie Ihrem Projekt ein remote_dependency hinzufügen und LookML prüfen. Klicken Sie auf die Schaltfläche, um die Remote-Projektdateien einzufügen. Wenn dies das erste Remote-Projekt ist, das Sie Ihrem Projekt hinzugefügt haben, wird bei der Aktualisierung der Abhängigkeiten zusätzlich Looker aufgefordert, eine Manifestdatei-Sperre zu erstellen. Looker verfolgt mithilfe der Manifestdatei die Version der Remote-Projekte. Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren im Abschnitt Neue Versionen eines Remote-Projekts automatisch erkennen.

override_constant

Mit dem Parameter override_constant können Sie den Wert einer Konstante überschreiben, die in einem importierten Projekt definiert wurde.

Der Parameter override_constant kann auch mit dem Parameter local_dependency für den Import lokaler Projekte verwendet werden.

Wenn Sie Dateien aus einem Projekt in ein anderes Projekt importieren, können Sie die Werte der Konstanten überschreiben, die in der Manifestdatei des importierten Projekts definiert sind. Wenn Sie den Wert einer Konstante überschreiben, wird für importierte Dateien, die auf diese Konstante verweisen, der neue Wert verwendet, der im Importprojekt angegeben wurde.

Wenn der Parameter export für eine im importierten Projekt definierte Konstante auf override_required oder override_optional festgelegt ist, kann der Unterparameter override_constant von local_dependency verwendet werden, um einen neuen Wert für diese Konstante bereitzustellen. Angenommen, in der Manifestdatei des importierten Projekts ist eine Konstante connection definiert:


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

Da in diesem Beispiel der Parameter export auf override_required festgelegt ist, muss sein Wert in der Manifestdatei des Importprojekts überschrieben werden:


project_name: "importing_project"

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

Weitere Informationen und ein weiteres Beispiel zum Überschreiben von Konstanten beim Importieren von Projekten finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.

Beispiel

Fügen Sie in einer Manifestdatei das Git-Repository „Google GA 360“ als Quelle für den Import von Dateien hinzu:

project_name: "thelook"

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