Nutzung
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcaccdcdc400f668fd8147f1"
Hierarchie
remote_dependency |
Standardwert
KeineAkzeptiert
|
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 Parameterlocal_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"
}