remote_dependency

Nutzung

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

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

Definition

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

Der Parameter remote_dependency gehört in die Manifestdatei Ihres Projekts. Wenn Ihr Projekt noch keine hat, können Sie eine Manifestdatei erstellen.

Der Parameter remote_dependency akzeptiert einen beliebigen Namen. Dieser Name wird in include-Anweisungen verwendet, um in LookML-Projekten auf die importierten Dateien zu verweisen. Der Name wird auch als Ordnername im Ordner imported_projects der Looker-IDE verwendet.

Außerdem 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. Beispiel: HTTPS verwenden:

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

Oder über SSH:

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

ref

Mit dem Unterparameter ref wird ein Git-Branch, ein Git-Release-Tag oder ein Commit-SHA des Git-Repositorys des Remote-Projekts angegeben, das in Ihr Looker-Projekt übernommen werden soll:

  • Git-Zweig: Sie können einen Git-Zweig angeben, damit Looker automatisch neue Commits für diesen Zweig aus dem Remote-Projekt erkennt. Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.
  • Git-Release-Tag: Sie können ein Git-Release-Tag angeben, wenn Looker neue Commits für dieses Tag automatisch aus dem Remote-Projekt erkennen soll. Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.
  • Git-Commit-SHA: Sie können einen Commit-SHA angeben, wenn Sie eine statische Versionsverwaltung wünschen, damit Änderungen im importierten Projekt nicht automatisch in Ihrem Projekt übernommen werden. In der Regel ist das der letzte Commit, aber das ist nicht erforderlich. Commit-SHAs finden Sie überall dort, wo Sie den Commit-Verlauf aufrufen können. Git-Dienstanbieter machen den SHA in der Regel gut sichtbar und kopierbar. Das ist eine gute Option für Looker Blocks.

Hier ist ein Beispiel für eine Remote-Abhängigkeit, die einen 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 Remote-Abhängigkeit, die den Hauptzweig des Remote-Git-Projekts angibt:

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

Unabhängig vom Typ von ref, den Sie angeben, wird in der IDE die Schaltfläche Update Dependencies (Abhängigkeiten aktualisieren) angezeigt, wenn Sie Ihrem Projekt ein remote_dependency hinzufügen und Ihre LookML validieren. Klicken Sie auf die Schaltfläche, um die Dateien des Remote-Projekts zu importieren. Wenn dies das erste Remote-Projekt ist, das Sie Ihrem Projekt hinzugefügt haben, werden Sie beim Aktualisieren von Abhängigkeiten auch aufgefordert, eine Manifest-Sperrdatei zu erstellen. Looker verwendet die Manifest-Sperrdatei, um die Version der Remote-Projekte zu verfolgen. Weitere Informationen finden Sie im Abschnitt Neue Versionen eines Remote-Projekts automatisch erkennen auf der Dokumentationsseite Dateien aus anderen Projekten importieren.

override_constant

Mit dem Parameter override_constant können Sie den Wert einer Konstanten ü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 importieren, können Sie die Werte von Konstanten überschreiben, die in der Manifestdatei des importierten Projekts definiert sind. Wenn Sie den Wert einer Konstanten überschreiben, wird in importierten Dateien, in denen auf diese Konstante verwiesen wird, der neue Wert aus dem importierenden Projekt verwendet.

Wenn der Parameter export für eine im importierten Projekt definierte Konstante auf override_required oder override_optional festgelegt ist, kann mit dem Unterparameter override_constant von local_dependency ein neuer Wert für diese Konstante angegeben werden. Angenommen, Sie haben in der Manifestdatei des importierten Projekts die Konstante connection definiert:


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

Da der Parameter export in diesem Beispiel auf override_required festgelegt ist, muss sein Wert in der Manifestdatei des importierenden Projekts ü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 für das Ü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 zum Importieren von Dateien hinzu:

project_name: "thelook"

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