Git-Verbindung einrichten und testen

Wenn Sie ein neues Projekt erstellen, ist es nur im Entwicklungsmodus verfügbar, damit Sie das Modell in einer sicheren Umgebung entwickeln können, die keine Auswirkungen auf andere Nutzer hat. Sobald Sie bereit sind, Ihr Projekt zu veröffentlichen, konfigurieren Sie im nächsten Schritt eine Git-Verbindung.

Wenn Sie eine Git-Verbindung für Ihr Projekt konfigurieren, können Sie Ihren LookML-Code im Produktionsmodus bereitstellen, in dem andere Nutzer Ihr Datenmodell untersuchen, Dashboards erstellen und Ihrem Modell LookML hinzufügen können. Für eine schnellere Einrichtung sollten Sie ein Bare Repository verwenden. Erstellen Sie für eine robustere Git-Integration Ihr eigenes Git-Repository und folgen Sie der Anleitung auf dieser Seite, um es mit Ihrer Looker-Instanz zu verbinden.

Looker in Git integrieren

Looker verwendet Git, um Änderungen aufzuzeichnen und Dateiversionen zu verwalten. Jedes LookML-Projekt entspricht einem Git-Repository. Jedes Mal, wenn sich ein Nutzer im Entwicklungsmodus befindet, befindet er sich in seinem eigenen Git-Zweig.

Für die Verwaltung von LookML-Quelldateien kann Looker mit jedem Git-Anbieter konfiguriert werden, der einen SSH-Schlüssel oder HTTPS für die Authentifizierung verwendet. Die allgemeinen Schritte sind immer gleich, unabhängig davon, welche Plattform Sie verwenden. Auf dieser Seite wird GitHub als Beispiel für die Verbindung eines Looker-Projekts mit Git verwendet, nachdem Sie ein Git-Repository erstellt haben.

Für den Zugriff auf Git-Integrationsoptionen muss der Entwicklungsmodus aktiviert sein.

Sie können die Git-Integration mit einem der folgenden Protokolle konfigurieren:

  • HTTPS: HyperText Transfer Protocol Secure. Mit HTTPS greift Looker mit einem von Ihnen angegebenen Nutzernamen und Passwort (oder Zugriffstoken) auf Ihr Git-Repository zu, wie unter Verbindung zu Git über HTTPS herstellen beschrieben.
  • SSH: Secure Shell Mit SSH greift Looker mit einem Bereitstellungsschlüssel auf Ihr Git-Repository zu, den Sie über die Website Ihres Git-Anbieters generieren, wie unter Verbindung zu Git über SSH herstellen beschrieben.

Über HTTPS mit Git verbinden

Bei LookML-Projekten, die mit HTTPS-Authentifizierung konfiguriert sind, stellt Looker eine Verbindung zu Ihrem Git-Anbieter mit einem oder mehreren Nutzerkonten her, die Sie bei Ihrem Git-Anbieter eingerichtet haben. Looker verwendet einen Nutzernamen und ein Passwort (oder ein Zugriffstoken), um sich bei Ihrem Git-Anbieter anzumelden und Git-Vorgänge im Namen Ihrer LookML-Entwickler auszuführen.

Wenn für Ihr Git-Konto die 2-Faktor-Authentifizierung verwendet wird, können Sie bei Ihrem Git-Anbieter Zugriffstokens erstellen und anstelle von Passwörtern verwenden. Im Communitybeitrag HTTPS-Git-Verbindung mit aktivierter 2FA einrichten finden Sie eine Anleitung zum Erstellen persönlicher Zugriffstokens für gängige Git-Anbieter.

Mit der HTTPS-Authentifizierung können Sie Ihr LookML-Projekt so konfigurieren, dass ein einzelnes Git-Konto für das gesamte Projekt verwendet wird, oder Sie können das Projekt so konfigurieren, dass die einzelnen Git-Konten Ihrer Entwickler für die Ausführung ihrer Git-Vorgänge verwendet werden.

Beachten Sie für die GitHub-HTTPS-Authentifizierung Folgendes:

  • GitHub akzeptiert keine Kontopasswörter zur Authentifizierung von Git-Vorgängen auf github.com. Weitere Informationen findest du im GitHub-Blogpost. Wenn Sie ein Looker-Projekt über HTTPS mit GitHub verbinden möchten, verwenden Sie die Entwicklereinstellungen in GitHub, um ein persönliches Zugriffstoken zu erstellen.
  • Looker unterstützt keine detaillierten persönlichen Zugriffstokens von GitHub. Wenn Sie Ihr Looker-Projekt über HTTPS mit GitHub verbinden möchten, verwenden Sie beim Erstellen eines persönlichen Zugriffstokens die GitHub-Option Tokens (klassisch).

HTTPS-Authentifizierung für ein einzelnes Konto

Wenn Sie Ihr LookML-Projekt mit einem einzelnen Git-Konto einrichten, verwendet Looker dieses Git-Konto, um sich bei Ihrem Git-Anbieter anzumelden und Änderungen im Namen der Entwickler durchzuführen. Looker führt diese Commits mithilfe des Looker-Benutzernamens des Entwicklers durch, sodass Sie feststellen können, welcher Entwickler den einzelnen Commit durchgeführt hat. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters oder durch Auswahl der Option Verlauf im Git-Menü der Looker-IDE aufrufen. Weitere Informationen zu den Git-Menüs in Looker finden Sie unter Git-Befehle in Looker ausführen.

Für die HTTPS-Authentifizierung mit einem einzelnen Konto muss das von Ihnen angegebene Git-Nutzerkonto Lese- und Schreibzugriff auf Ihr Git-Repository haben. Ihre LookML-Entwickler selbst benötigen keine eigenen Git-Nutzerkonten.

HTTPS-Authentifizierung für mehrere Konten mit Nutzerattributen

Wenn Sie Ihr LookML-Projekt mit mehreren Konten einrichten, verwendet Ihr LookML-Projekt das individuelle Git-Konto jedes Looker-Entwicklers, um Git-Vorgänge auszuführen. Außerdem müssen Sie ein generisches Git-Nutzerkonto mit mindestens Lesezugriff konfigurieren, das Looker zum Abrufen der Produktionsversion der Dateien verwendet.

Für die Git-Authentifizierung mit Nutzerattributen sind die folgenden Aufgaben und Anforderungen erforderlich:

  • Jeder Ihrer LookML-Entwickler muss über ein eigenes Nutzerkonto bei Ihrem Git-Anbieter verfügen. Jedes Git-Nutzerkonto muss Lese- und Schreibzugriff auf das Repository des Projekts haben.
  • Ihr Looker-Administrator muss Looker-Nutzerkonten mit Nutzerattributen einrichten, die dem Git-Nutzernamen und dem Git-Passwort entsprechen (oder ein Zugriffstoken, wenn die Git-Nutzerkonten eine 2-Faktor-Authentifizierung haben).
  • Nutzerattribute für Git-Kontopasswörter (oder Zugriffstokens) müssen ausgeblendet werden. Wählen Sie beim Erstellen des Passwort- oder Zugriffstokenattributs die Option Ja unter der Option Werte ausblenden aus und geben Sie die URL des Git-Anbieters in das Feld Domain-Zulassungsliste ein.
  • Die Nutzerattribute für Git-Name und Passwort (oder Zugriffstoken) müssen für jeden Looker-Entwickler ausgefüllt werden. Nutzerattribute können von einem Looker-Administrator oder vom Looker-Nutzer konfiguriert werden.

Das folgende Beispiel zeigt die Seite Nutzerattribute auf der Seite „Verwaltung“, auf der ein Looker-Administrator Nutzerattribute für den Git-Nutzernamen und das Nutzerzugriffstoken eingerichtet hat.

Tabelle auf der Seite „Benutzerattribute-Verwaltung“ mit den String-Nutzerattributen „github_token“ und „github_username“.

Das folgende Beispiel zeigt die Seite Konto eines Looker-Nutzers, auf der der Nutzer seine Git-Anmeldedaten in die Felder für Nutzerattribute eingegeben hat.

HTTPS-Git-Authentifizierung konfigurieren

So konfigurieren Sie ein LookML-Projekt mit HTTPS-Git-Authentifizierung:

  1. Rufen Sie die HTTPS-URL für Ihr Git-Repository ab. Im Fall von GitHub zeigt Ihnen GitHub bei neuen Repositories (Repositories, die noch keine Dateien enthalten) die URL im Rahmen der Ersteinrichtung an. Achten Sie darauf, auf dem Tab Code die Schaltfläche HTTPS auszuwählen, damit Sie die HTTPS-URL erhalten. Wählen Sie dann das Symbol URL in Zwischenablage kopieren aus, um sie in die Zwischenablage zu kopieren.

    Bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten) können Sie die HTTPS-URL sehen, indem Sie zum Tab Code des Repositorys wechseln und die Schaltfläche Code auswählen. Achten Sie darauf, den Link HTTPS auszuwählen. Du kannst das Symbol URL in Zwischenablage kopieren auswählen, um die HTTPS-URL in die Zwischenablage zu kopieren.

  2. Gehen Sie zu Ihrem LookML-Projekt und wählen Sie in der Navigationsleiste das Symbol Einstellungen aus.

  3. Klicken Sie auf der Seite Projektkonfiguration auf dem Tab Konfiguration auf die Schaltfläche Git konfigurieren (für neue Projekte) oder auf die Schaltfläche Git-Verbindung zurücksetzen (bei vorhandenen Projekten, die bereits mit Git verbunden wurden).

  4. Wählen Sie die Schaltfläche Konfigurieren oder Git-Verbindung zurücksetzen aus, um die Seite Git konfigurieren zu öffnen.

    Beim Zurücksetzen Ihrer Git-Verbindung wird der Git-Verlauf für den Hauptzweig beibehalten. Außerdem wird der Verlauf des persönlichen Zweigs jedes Looker-Entwicklers nach dem Abrufen, Zusammenführen und Bereitstellen gespeichert. Informationen zum Beibehalten des Verlaufs für alle Zweige finden Sie auf der Seite mit den Best Practices unter Zu einem neuen Git-Repository migrieren.

  5. Fügen Sie auf der Looker-Seite Git konfigurieren die HTTPS-URL für Ihr Git-Repository in das Feld Repository-URL ein und wählen Sie dann Weiter aus.

    Looker erkennt Ihren Git-Anbieter und aktualisiert das Fenster mit Informationen zu Ihrem Git-Repository.

    Wenn Looker Ihren Git-Anbieter nicht erfolgreich erkennt, werden Sie aufgefordert, ihn aus einer Drop-down-Liste auszuwählen.

  6. Wählen Sie Ihre Git-Anmeldeoption aus:

  7. Geben Sie in den Feldern Nutzername und Passwort/Persönliches Zugriffstoken die Anmeldedaten ein, mit denen Ihr LookML-Projekt für den Zugriff auf Git verwendet wird. Dies ist unabhängig von Ihrer Git-Anmeldeeinstellung erforderlich:

    • Wenn Sie Einzelnen, konstanten Nutzernamen und eine Kombination aus Passwort und persönlichem Zugriffstoken verwenden ausgewählt haben, sind dies der Git-Nutzername und -Passwort (oder Zugriffstoken), die Ihre Looker-Instanz für alle Git-Vorgänge verwendet. Dieses Git-Nutzerkonto muss Lese- und Schreibzugriff auf Ihr Git-Repository haben.
    • Wenn Sie Nutzerattribute für Nutzername und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, sind dies der Git-Nutzername und -Passwort (oder Zugriffstoken), mit denen Ihre Looker-Instanz die Produktionsversion des Repositorys abrufen wird. Dieses Git-Nutzerkonto muss mindestens Lesezugriff auf Ihr Git-Repository haben.

    Wenn Ihr Git-Konto die 2-Faktor-Authentifizierung verwendet oder Sie GitHub verwenden (für das ein persönliches Zugriffstoken anstelle eines Passworts erforderlich ist), können Sie bei Ihrem Git-Anbieter Zugriffstokens erstellen, die anstelle von Passwörtern verwendet werden. Eine Anleitung zum Erstellen persönlicher Zugriffstokens für gängige Git-Anbieter finden Sie im Communitybeitrag HTTPS-Git-Verbindung mit aktivierter 2FA einrichten .

  8. Wenn Sie die Option Nutzerattribute für Nutzername und Passwort/persönliches Zugriffstoken verwenden ausgewählt haben, zeigt Looker im Abschnitt Anmeldedaten für den Entwicklungsmodus die Drop-down-Menüs Nutzername-Nutzerattribut und Nutzerattribut des persönlichen Zugriffstokens an. Wählen Sie über die Drop-down-Menüs die Nutzerattribute für die Git-Anmeldedaten eines einzelnen Entwicklers aus.

    Looker-Nutzer können die Werte für ihre Nutzerattributfelder auf der Seite Konto bearbeiten. Looker-Administratoren können die Nutzerattributwerte für einen Nutzer auf der Administratorseite Nutzer bearbeiten.

  9. Wählen Sie die Schaltfläche Einrichtung fortsetzen aus.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihren LookML-Code validieren und dann Ihren ersten Commit erstellen und für die Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

SSH-Verbindung zu Git herstellen

Mit der SSH-Authentifizierung erstellen Sie einen Bereitstellungsschlüssel für Ihren Git-Anbieter. Looker generiert das SSH-Schlüsselpaar und zeigt den öffentlichen Schlüssel in der Benutzeroberfläche an, wie in Schritt 4 beschrieben. Looker verwendet diesen Bereitstellungsschlüssel, um sich bei Ihrem Git-Anbieter anzumelden und Änderungen im Namen der Looker-Entwickler vorzunehmen. Looker erstellt Commits mit dem Looker-Benutzernamen eines Entwicklers, damit Sie sehen können, von welchem Entwickler jeder Commit durchgeführt wurde. Sie können den Commit-Verlauf Ihres Projekts auf der Benutzeroberfläche Ihres Git-Anbieters oder durch Auswahl der Option Verlauf im Git-Menü der Looker-IDE aufrufen. Weitere Informationen zu den Git-Menüs in Looker finden Sie unter Git-Befehle in Looker ausführen .

So konfigurieren Sie ein LookML-Projekt mit SSH-Git-Authentifizierung:

  1. Öffnen Sie Ihr Projekt oder erstellen Sie ein neues LookML-Projekt.
  2. Wählen Sie in Ihrem Projekt im Symbolmenü auf der linken Seite das Symbol Einstellungen aus, um die Seite Projektkonfiguration zu öffnen.

  3. Führen Sie auf der Seite Projektkonfiguration eine der folgenden Aktionen aus, um die Seite Git konfigurieren zu öffnen:

    • Wählen Sie für ein Projekt ohne Git-Verbindung die Schaltfläche Konfigurieren aus.
    • Wählen Sie für ein Projekt, das bereits mit einer Git-Verbindung konfiguriert ist, die Schaltfläche Git-Verbindung zurücksetzen aus.

    Beim Zurücksetzen Ihrer Git-Verbindung wird der Git-Verlauf für den Hauptzweig beibehalten. Außerdem wird der Verlauf des persönlichen Zweigs jedes Looker-Entwicklers nach dem Abrufen, Zusammenführen und Bereitstellen gespeichert. Informationen zum Beibehalten des Verlaufs für alle Zweige finden Sie auf der Seite mit den Best Practices unter Zu einem neuen Git-Repository migrieren.

    Diagramm, das den Verlauf von der Seite mit den Projekteinstellungen zur Seite „Git konfigurieren“ zeigt. Für neue Projekte wird die Schaltfläche „Git konfigurieren“ angezeigt und für bestehende Projekte die Schaltfläche „Git Connect zurücksetzen“. Beide Schaltflächen führen jedoch zur Seite „Git konfigurieren“.

  4. Rufen Sie die SSH-URL für Ihr Git-Repository ab. Hier sind die Formate für gängige Git-Anbieter:

    • GitHub: git@github.com:<organization-name>/<repository-name>.git
    • GitHub Enterprise: git@example.com:<organization-name>/<repository-name>.git
    • Cloud Source Repositories: ssh://username@example.com@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
    • GitLab: git@gitlab.com:<organization-name>/<repository-name>.git
    • Bitbucket: git@bitbucket.org:<organization-name>/<repository-name>.git
    • Phabricator: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Im Fall von GitHub zeigt GitHub bei neuen Repositories (Repositories, die noch keine Dateien enthalten) bei der Ersteinrichtung die SSH-URL auf dem Tab Code an. Klicken Sie auf die Schaltfläche SSH, um die SSH-URL zu erhalten. Klicken Sie dann auf das Symbol für die Zwischenablage, um sie in die Zwischenablage zu kopieren.

    Bei vorhandenen GitHub-Repositories (Repositories, die bereits Dateien enthalten) können Sie die SSH-URL sehen, indem Sie den Tab Code des Repositorys aufrufen und auf die Schaltfläche Code klicken. Vergessen Sie nicht, den Link Use SSH (SSH verwenden) auszuwählen. Du kannst das Symbol für die Zwischenablage auswählen, um es in die Zwischenablage zu kopieren.

  5. Fügen Sie auf der Looker-Seite Git konfigurieren die SSH-URL für Ihr Git-Repository in das Feld Repository-URL ein und wählen Sie dann Weiter aus.

    URLs mit benutzerdefinierten oder nicht standardmäßigen Git-Ports können mit Looker verwendet werden. Dazu fügen Sie der Git-URL die nicht standardmäßige Portnummer hinzu. Beispiel: ssh://git@corporate.git.server.com:22/myorganization/myproject.git

    Sie müssen ssh:// angeben, damit dies richtig funktioniert.

  6. Looker erkennt Ihren Git-Anbieter und zeigt einen Bereitstellungsschlüssel für Ihr Repository an. (Wenn Looker Ihren Git-Anbieter nicht erfolgreich erkennt, werden Sie aufgefordert, einen Eintrag aus einem Drop-down-Menü auszuwählen.) Kopieren Sie den Bereitstellungsschlüssel in die Zwischenablage und wählen Sie den Link Deploy Key settings for your Repository (Schlüsseleinstellungen für Ihr Repository bereitstellen) aus, um die GitHub-Seite Deploy keys (Schlüssel bereitstellen) für Ihr GitHub-Repository zu öffnen.

  7. Klicken Sie auf dem GitHub-Tab Einstellungen auf der Seite Schlüssel bereitstellen auf die Schaltfläche Bereitstellungsschlüssel hinzufügen:

    GitHub zeigt die Seite Schlüssel bereitstellen / Neu hinzufügen an.

  8. Fügen Sie einen Titel für den Bereitstellungsschlüssel hinzu. Der Name ist nicht wichtig, aber Sie können „Looker“ und Ihren Projekttitel angeben, um ihn in Zukunft im Auge zu behalten.

  9. Fügen Sie den Bereitstellungsschlüssel ein, den Sie aus Looker kopiert haben .

  10. Wählen Sie die Option Schreibzugriff erlauben aus.

  11. Wählen Sie die Schaltfläche Schlüssel hinzufügen aus. (An diesem Punkt fordert Sie Ihr Git-Anbieter möglicherweise auf, Ihr Passwort einzugeben. Geben Sie in diesem Fall Ihr Passwort ein und wählen Sie Passwort bestätigen aus.

  12. GitHub zeigt alle Bereitstellungsschlüssel an, die für Ihr Repository hinzugefügt wurden.

  13. Gehen Sie zurück zum Looker-Fenster und wählen Sie auf der Seite Git konfigurieren die Option Einrichtung testen und abschließen aus.

Hier können Sie noch einmal versuchen, den Bereitstellungsschlüssel einzurichten, oder Tests überspringen und Einrichtung abschließen auswählen, um Ihre aktuellen Einstellungen beizubehalten.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihren LookML-Code validieren und dann Ihren ersten Commit erstellen und für die Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

Bare-Git-Repository konfigurieren

Wenn Sie noch kein Remote-Git-Repository erstellt haben oder es schnell einrichten möchten, damit andere von Ihrem LookML-Code profitieren können, können Sie ein reines Git-Repository konfigurieren. Durch das Konfigurieren eines Bare-Git-Repositorys wird ein lokales Git-Repository auf Ihrer Looker-Instanz erstellt, anstatt eine Verbindung zu einem Remote-Repository herzustellen.

Wenn Sie die Option zum Erstellen eines reinen Repositorys auswählen, erstellt Looker das Repository auf Ihrem Looker-Server und startet den Git-Verlauf für das Repository.

So konfigurieren Sie ein LookML-Projekt mit einem reinen Git-Repository:

  1. Öffnen Sie Ihr Projekt oder erstellen Sie ein neues LookML-Projekt.
  2. Wählen Sie in Ihrem Projekt im Symbolmenü auf der linken Seite das Symbol Einstellungen aus, um die Seite Projektkonfiguration zu öffnen.

  3. Führen Sie auf der Seite Projektkonfiguration eine der folgenden Aktionen aus, um die Seite Git konfigurieren zu öffnen:

    • Wählen Sie für ein Projekt ohne Git-Verbindung die Schaltfläche Konfigurieren aus.
    • Wählen Sie für ein Projekt, das bereits mit einer Git-Verbindung konfiguriert ist, die Schaltfläche Git-Verbindung zurücksetzen aus.

    Beim Zurücksetzen Ihrer Git-Verbindung wird der Git-Verlauf für den Hauptzweig beibehalten. Außerdem wird der Verlauf des persönlichen Zweigs jedes Looker-Entwicklers beibehalten, sobald dieser abgerufen, zusammengeführt und dann bereitgestellt wird. Informationen zum Beibehalten des Verlaufs für alle Zweige finden Sie auf der Seite mit den Best Practices unter Zu einem neuen Git-Repository migrieren.

  4. Wählen Sie unten auf der Seite Git konfigurieren über der Schaltfläche Weiter die Option Stattdessen ein Bare-Repository einrichten aus.

  5. Wählen Sie im Dialogfeld Bare Git-Repository konfigurieren die Option Repository erstellen aus.

    Nachdem das Git-Repository erstellt wurde, zeigt Looker das Dialogfeld Bare Repository erstellt an.

Git ist jetzt für Ihr LookML-Projekt konfiguriert. Von hier aus können Sie Ihren LookML-Code validieren und dann Ihren ersten Commit erstellen und für die Produktion bereitstellen, um Ihr Projekt im Produktionsmodus verfügbar zu machen. Weitere Optionen:

Bei Projekten, die mit einem reinen Repository konfiguriert sind, können Sie anschließend Git-Verbindung zurücksetzen verwenden, um das Projekt mit einem Git-Anbieter zu verbinden. Weitere Informationen finden Sie in den Verfahren zur Verwendung von HTTPS oder SSH. Stellen Sie jedoch keine Verbindung zu einem Git-Repository her, das bereits einen Git-Verlauf hat. Wenn Sie Ihr LookML-Projekt mit einem reinen Repository eingerichtet haben, erstellt Looker ein Repository auf Ihrem Looker-Server und startet den Git-Verlauf für das Repository. Wenn Sie Ihr LookML-Projekt anschließend mit einem Git-Repository mit Git-Verlauf verbinden, kann Looker die beiden Git-Verläufe nicht abgleichen und Sie können keine Git-Aktionen ausführen.

Neues LookML-Projekt mit einem nicht leeren Git-Repository verbinden

Das Konfigurieren von Git für die Versionsverwaltung ist ein wichtiger Schritt beim Erstellen eines neuen LookML-Projekts. Normalerweise sollte jedes Projekt ein eigenes Repository haben. Möglicherweise müssen Sie jedoch ein Projekt mit einem Git-Repository konfigurieren, das vorhandene LookML-Elemente enthält, z. B. in den folgenden Situationen:

  • Wenn Sie ein vorhandenes LookML-Projekt zwischen Instanzen verschieben
  • Wenn Sie den Code aus einem fehlerhaften oder veralteten LookML-Projekt zur Verwendung in einem neuen Projekt wiederherstellen

In diesem Abschnitt werden Best Practices zum Konfigurieren eines neuen LookML-Projekts mit einem vorhandenen, nicht leeren Git-Repository für die weitere LookML-Entwicklung beschrieben.

  1. Erstellen Sie ein neues LookML-Projekt, indem Sie Leeres Projekt als Ausgangspunkt auswählen. Ein leeres Projekt ist der Ausgangspunkt, da es mit LookML-Objekten aus einem vorhandenen Repository und nicht aus einem Datenbankschema oder einer SQL-Abfrage gefüllt wird.
  2. Konfigurieren Sie Git für Ihr Projekt entweder mit HTTPS oder SSH und verwenden Sie dabei die URL für das nicht leere Projekt im Abschnitt Repository-URL der Seite Git konfigurieren.
  3. Nachdem Sie Git für Ihr Projekt konfiguriert haben, können Sie im Bereich Git Actions (Git-Aktionen) die Daten aus der Produktion abrufen.
  4. Nachdem Sie Daten aus der Produktion abgerufen haben, wählen Sie In Produktion bereitstellen aus.

Änderungen, die Sie in Ihrem Projekt an LookML vornehmen, wirken sich nicht auf das ursprüngliche Repository aus. Sie werden lediglich in Ihrer lokalen Version des Repositorys gespeichert.

Wenn Sie ein bestimmtes öffentliches Repository als Grundlage für ein leeres LookML-Projekt verwenden möchten, aber keinen Schreibzugriff darauf haben, folgen Sie der Anleitung im Abschnitt Öffentliches Git-Repository klonen der Dokumentationsseite Neues LookML-Projekt erstellen.

Wenn Sie einen Git-Workflow mit einem Repository auf mehreren Instanzen einrichten, lesen Sie den Community-Beitrag zum Git-Workflow mit einem Repository für mehrere Instanzen – Entwicklung, Staging und Produktion.

Git-Verbindung testen

Looker bietet einen Git-Verbindungstest, um Ihre Git-Verbindung zu überprüfen. Der Git-Verbindungstest überprüft, ob Sie die richtige Git-URL eingerichtet haben und ob der Git-Host für Looker erreichbar ist . Der Git-Verbindungstest prüft außerdem, ob Sie einen gültigen Git-Bereitstellungsschlüssel angegeben haben und ob der Bereitstellungsschlüssel Schreibzugriff auf Ihr Git-Repository hat.

Wenn Looker keine Verbindung zu Ihrem Git-Repository herstellen kann, wird auf der Git-Schaltfläche der Text Test Git Connection (Git-Verbindung testen) angezeigt. Damit werden Sie aufgefordert, einen Verbindungsfehler zu beheben.

Sie können auch auf das Testtool für Git-Verbindungen zugreifen, indem Sie im Bereich Git actions (Git-Aktionen) die Option Test Git Connection (Git-Verbindung testen) auswählen:

Das Tool zum Testen der Git-Verbindung zeigt dann die Schritte zum Testen der Git-Verbindung an:

  1. Git Remote untersuchen
  2. Hostname für Git-Dienst wird aufgelöst
  3. Das Netzwerk zum Git-Dienst ist betriebsbereit
  4. Anmeldedaten für die Autorisierung überprüfen
  5. Prüfen, ob Anmeldedaten Schreibzugriff gewähren

Wenn ein Schritt erfolgreich war, zeigt Looker links neben dem Schritt ein grünes Häkchen an. Wenn ein Schritt fehlgeschlagen ist, zeigt Looker links neben dem Schritt ein rotes Häkchen sowie eine Fehlermeldung an.

Das folgende Beispiel zeigt einen erfolgreichen Test:

Dialogfeld für Git-Verbindungstest mit einer Liste von Schritten mit grünen Häkchen daneben, um anzuzeigen, dass alle Schritte erfolgreich waren.

Im folgenden Beispiel ist im Git-Repository kein Bereitstellungsschlüssel für die Looker-Verbindung konfiguriert. Die grünen Häkchen links neben den ersten drei Schritten geben an, dass diese Schritte erfolgreich waren:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

Die roten Häkchen links neben den letzten beiden Schritten zeigen an, dass diese Schritte fehlgeschlagen sind:

  • Verify authorization credentials
  • Ensure credentials allow write access

Dialogfeld für Git-Verbindungstest mit einer Liste erfolgreicher und fehlgeschlagener Schritte. Beim Schritt „Anmeldedaten für die Autorisierung überprüfen“ wird der Fehler „Authentifizierung bei Remote-Zugriff nicht möglich (Looker-Bereitstellungsschlüssel)“ angezeigt.