Versionsverwaltung und Bereitstellung

Auf dieser Seite wird davon ausgegangen, dass das Projekt bereits für die Versionsverwaltung eingerichtet ist. Wenn Sie anstelle der auf dieser Seite beschriebenen Optionen die Schaltfläche Git konfigurieren sehen, müssen Sie zuerst Git für Ihr Projekt einrichten.

Looker verwendet Git, um Änderungen zu erfassen und Dateiversionen zu verwalten. Jedes LookML-Projekt entspricht einem Git-Repository und jeder Entwicklerzweig entspricht einem Git-Zweig.

Looker kann für viele Git-Anbieter wie GitHub, GitLab und Bitbucket konfiguriert werden. Informationen zum Einrichten von Git für Ihr Looker-Projekt finden Sie in der Dokumentation zum Einrichten und Testen einer Git-Verbindung.

Mit Git-Zweigen arbeiten

Einer der Hauptvorteile von Git ist, dass ein Looker-Entwickler in einem Zweig, einer isolierten Version eines Datei-Repositorys, arbeiten kann. Sie können Anwendungen entwickeln und testen, ohne andere Nutzer zu beeinträchtigen. Als Entwickler in Looker verwenden Sie immer einen Git-Zweig, wenn Sie sich im Entwicklungsmodus befinden.

Ein weiteres wichtiges Merkmal von Git ist die einfache Zusammenarbeit mit anderen Entwicklern. Sie können einen Zweig erstellen und bei Bedarf Änderungen im Zweig vornehmen. Wenn ein anderer Entwickler Änderungen am Zweig vorgenommen hat, wird in Looker die Schaltfläche Remote-Änderungen abrufen angezeigt. Sie sollten diese zugesicherten Änderungen am Zweig abrufen, bevor Sie weitere Änderungen vornehmen.

Sie können auch einen Zweig löschen, der keine Masterzweig, Ihr aktueller Zweig oder der private Zweig eines Entwicklers ist.

Persönliche Zweige

Wenn Sie den Entwicklungsmodus zum ersten Mal aufrufen, wird in Looker automatisch ein persönlicher Git-Zweig erstellt. Ihr persönlicher Zweig beginnt mit dev- und enthält Ihren Namen.

Ihr persönlicher Zweig ist spezifisch und kann nicht gelöscht werden. Ihr persönlicher Zweig ist für alle anderen Entwickler schreibgeschützt. Wenn Sie bei einem Projekt mit anderen Entwicklern zusammenarbeiten, können Sie einen neuen Zweig erstellen, damit andere Nutzer dorthin wechseln und ebenfalls Änderungen vornehmen können.

Neuen Git-Zweig erstellen

Wenn Sie nur an einer einfachen Lösung arbeiten und nicht mit anderen Entwicklern zusammenarbeiten, ist Ihr persönlicher Standort normalerweise ein guter Arbeitsplatz. Sie können Ihren persönlichen Zweig verwenden, um schnelle Aktualisierungen vorzunehmen und dann die Änderungen zu übernehmen und an die Produktion zu senden.

Sie können zusätzlich zu Ihrem persönlichen Zweig auch neue Git-Zweige erstellen. Ein neuer Git-Zweig ist in folgenden Fällen sinnvoll:

  • Sie arbeiten mit anderen Entwicklern zusammen. Da Ihr persönlicher Zweig für andere Entwickler schreibgeschützt ist, sollten Sie einen neuen Git-Zweig erstellen, wenn Sie mit anderen Entwicklern zusammenarbeiten möchten, damit andere Entwickler in diesen Zweig schreiben können. Wenn Sie mit anderen zusammenarbeiten, sollten Sie jedes Mal Änderungen vornehmen, wenn Sie die Arbeit fortsetzen. So erhalten Sie die neuesten Updates aller Entwickler, bevor Sie fortfahren.
  • Sie arbeiten gleichzeitig an mehreren Funktionen. Manchmal befinden Sie sich mitten in einem größeren Projekt, möchten aber ein kleineres Problem beheben oder eine schnelle Lösung vornehmen. In diesem Fall können Sie Ihre Änderungen per Commit auf den Zweig übertragen, den Sie aktuell verwenden, und anschließend zu einem anderen Zweig wechseln, um mit separaten Funktionen zu arbeiten. Sie können das Problem im neuen Zweig beheben und dann die Änderungen an diesem Zweig in der Produktion bereitstellen, bevor Sie die Arbeit in Ihrem ursprünglichen Zweig fortsetzen.

Bevor Sie einen neuen Zweig erstellen:

  • Wenn es in Ihrem aktuellen Zweig zu einem Konflikt kommt, müssen Sie den Konflikt lösen, bevor Sie einen neuen Zweig erstellen können.
  • Wenn Sie für den aktuellen Zweig Änderungen nicht übernommen haben, müssen Sie die Änderungen per Commit speichern, bevor Sie einen neuen Zweig erstellen.
  • Wenn Sie einen Zweig erstellen möchten, der auf einem vorhandenen Entwicklungszweig und nicht auf dem Produktionszweig beginnt, rufen Sie zuerst die neueste Version des Entwicklungszweigs ab. Wechseln Sie dazu zu diesem Entwicklungszweig und ziehen Sie dann Remoteänderungen hoch, um Ihre lokale Version dieses Zweigs zu synchronisieren.

So erstellen Sie einen neuen Git-Zweig:

  1. Prüfen Sie, ob der Entwicklungsmodus aktiviert ist.

  2. Rufen Sie Ihre Projektdateien im Menü Entwickeln auf.

  3. Wählen Sie im Menü auf der linken Seite das Symbol Git aus, um den Bereich Git Actions zu öffnen.

  4. Wählen Sie das Drop-down-Menü Zweige ansehen aus.

  5. Wählen Sie Neuer Zweig aus.

  6. Geben Sie im Fenster Neuer Zweig einen Namen für den Zweig ein. Beachten Sie, dass bei Git-Zweignamen Einschränkungen gelten. Informationen zu den Anforderungen für die Benennung finden Sie auf dieser Seite unter Regeln für die Benennung eines Git-Zweigs.

  7. Wählen Sie das Drop-down-Menü Create from (Erstellen aus) aus und wählen Sie einen vorhandenen Zweig aus, der als Ausgangspunkt für den neuen Zweig verwendet werden soll.

  8. Wählen Sie Erstellen aus, um den Zweig zu erstellen.

Alternativ können Sie Git-Zweige auf der Seite Projekteinstellungen auf dem Tab Zweigverwaltung erstellen.

Regeln für die Benennung eines Git-Zweigs

Looker verwendet die von Git angegebenen Zweignamen-Namenskonvention.

Git-Zweignamen dürfen nicht

  • Enthält ein Leerzeichen
  • Enthält einen doppelten Punkt: ..
  • Enthält einen umgekehrten Schrägstrich: \
  • Enthält die Sequenz: @{
  • Enthält ein Fragezeichen: ?
  • Enthält eine öffnende eckige Klammer: [
  • ASCII-Steuerzeichen: ~, \^ oder :
  • Mit einem Punkt beginnen: .
  • Beginnen Sie mit dem Präfix: dev- (reserviert für die privaten Zweige von Looker-Entwicklern)
  • Mit einem Schrägstrich enden: /
  • Mit der Erweiterung enden: .lock

Darüber hinaus darf der Zweigname nur ein Sternchen (*) enthalten, wenn das Sternchen eine ganze Pfadkomponente darstellt (z. B. foo/* oder bar/*/baz). In diesem Fall wird es als Platzhalter und nicht als Teil des tatsächlichen Zweignamens interpretiert.

Zu einem anderen Git-Zweig wechseln

Wenn es in Ihrem aktuellen Zweig zu einem Konflikt kommt, müssen Sie den Konflikt lösen, bevor Sie zu einem anderen Zweig wechseln können.

Wenn Sie in Ihrem aktuellen Zweig nicht zugesicherte Änderungen haben, können Sie erst zu einem vorhandenen Zweig wechseln, wenn Sie für den aktuellen Zweig die Änderungen per Commit speichern.

So wechseln Sie zu einem anderen Git-Zweig:

  1. Gehen Sie im Projekt zum Bereich Git Actions (Git-Aktionen), indem Sie im Menü auf der linken Seite auf das Git-Symbol klicken.
  2. Wählen Sie im Bereich Git Actions (Git-Aktionen) rechts neben dem aktuellen Git-Zweignamen das Drop-down-Menü „Git-Zweig“ aus.
  3. Wählen Sie den Zweig aus, zu dem Sie wechseln möchten, indem Sie ihn im Menü auswählen oder den Namen des Zweigs in das Suchfeld eingeben. Bei der Suche nach Zweignamen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn Sie beispielsweise nach „DEV“ suchen, sehen Sie alle Zweige mit Namen, die „dev“, „DEV“, „Dev“ usw. enthalten.

Git-Zweige verwalten

Auf dem Tab Zweigverwaltung der Seite Projekteinstellungen wird eine Tabelle aller Git-Zweige für das Looker-Projekt angezeigt. Öffnen Sie zum Öffnen des Tabs Zweigverwaltung zuerst die Seite Projekteinstellungen, indem Sie im Menü auf der linken Seite das Symbol Einstellungen auswählen. Wählen Sie als Nächstes den Tab Zweigverwaltung aus.

Auf dem Tab Zweigverwaltung können Sie:

  1. Erstellen Sie einen neuen Zweig, indem Sie auf die Schaltfläche Neuer Zweig klicken. Weitere Informationen finden Sie im Abschnitt Neuen Git-Zweig erstellen auf dieser Seite.
  2. Suchen Sie in der Suchleiste nach Zweignamen.
  3. Aktualisieren Sie die Tabelle, indem Sie auf die Schaltfläche Aktualisieren klicken.
  4. Wählen Sie einen Spaltennamen aus, um die Tabelle zu sortieren.

Die Tabelle enthält die folgenden Informationen:

  • Name: Name des Git-Zweigs. Die privaten Zweige von Looker-Entwicklern beginnen mit dev- und enthalten den Vor- und Nachnamen des Entwicklers.
  • Status: Die Differenz zwischen Ihrer lokalen Version des Zweigs und der Remote-Version des Zweigs. Der Status 3 commits behind bedeutet beispielsweise, dass Ihre lokale Version des Zweigs um drei Commits hinter der Remote-Version des Zweigs liegt. Da in Looker immer die Remote-Version des Masters verwendet wird, zeigt der Tab Zweigverwaltung den Status der lokalen Version des Masterzweigs nicht an. Der Master-Zweig kann immer als aktuell betrachtet werden.
  • Zuletzt aktualisiert: Zeitspanne seit der Zusicherung eines Looker-Entwicklers für den Zweig.
  • Aktionen: Eine Schaltfläche zum Löschen des Zweigs oder der Grund, warum der Zweig nicht gelöscht werden kann.

Git-Zweige löschen

Auf dem Tab Zweigverwaltung können Sie Zweige löschen, die in der Tabelle die Schaltfläche Löschen enthalten. Sie können die folgenden Zweige nicht löschen:

In der Tabelle enthalten diese Zweige keine Schaltfläche Löschen. Stattdessen wird in der Spalte Aktion der Tabelle angezeigt, warum der Zweig nicht gelöscht werden kann.

Sie können einen Zweig nach dem Löschen nicht wiederherstellen. Wenn Sie einen Zweig löschen, entfernt Looker sowohl Ihre lokale Version des Zweigs als auch die Remote-Version des Zweigs.

Wenn der Zweig jedoch von einem anderen Looker-Entwickler erstellt wurde oder andere Entwickler den Zweig überprüft haben, haben diese Entwickler weiterhin ihre lokale Version des Zweigs. Wenn ein Looker-Entwickler Commits an seiner lokalen Version des Zweigs durchführt und ihn in die Produktion überträgt, wird wieder eine Remote-Version des Zweigs angezeigt. Das kann hilfreich sein, wenn Sie den Zweig wiederherstellen möchten. Wenn Sie einen Zweig löschen, sollten alle anderen Looker-Entwickler denselben Zweig löschen, damit er nicht versehentlich von einer Person per Push an die Fernbedienung übertragen wird.

Wenn Sie einen oder mehrere Git-Zweige aus Ihrem Projekt löschen möchten, rufen Sie zuerst die Seite Projekteinstellungen auf, indem Sie im Menü auf der linken Seite das Symbol Einstellungen auswählen. Wählen Sie dann den Tab Zweigverwaltung aus. Auf dem Tab Zweigverwaltung können Sie Zweige auf zwei Arten löschen:

  1. Wenn Sie mehrere Zweige löschen möchten, klicken Sie zuerst die Kästchen der entsprechenden Zweige an und wählen Sie dann Ausgewählte Zweige löschen aus.
  2. Wenn Sie einen einzelnen Zweig löschen möchten, wählen Sie neben dem Zweignamen Löschen aus.

Git-Befehle in Looker ausführen

Looker verfügt über eine integrierte Oberfläche, die sich in Ihren Git-Dienst einbinden lässt. In Looker wird oben rechts in der LookML IDE die Git-Schaltfläche angezeigt.

Die Schaltfläche „Git“ zeigt unterschiedliche Optionen an, je nachdem, wo Sie gerade Änderungen vornehmen und in der Produktion bereitstellen. Im Allgemeinen ist die Option auf der Schaltfläche die beste Anleitung für Ihre nächste Aktion.

Wenn Ihr Entwicklerzweig mit dem Produktionszweig synchron ist, wird auf der Git-Schaltfläche die Meldung Aktuell angezeigt. Sie kann nicht ausgewählt werden.

Sobald Ihr Projekt für Git konfiguriert ist, können Sie die Schaltfläche Git Actions auswählen, um den Bereich Git Actions zu öffnen.

Welche Befehle im Bereich Git Actions verfügbar sind, hängt davon ab, wo Sie gerade Änderungen vornehmen und die Produktion ausführen.

Änderungen in die Produktion übernehmen

Bei der standardmäßigen Looker-Git-Einbindung werden Entwickler von Looker über den folgenden Git-Workflow aufgefordert:

Das bedeutet, dass bei der standardmäßigen Git-Integration alle Entwickler ihre Änderungen in einem Zweig namens master zusammenführen. Das letzte Commit für den master-Zweig wird für die Produktionsumgebung von Looker verwendet.

Bei erweiterten Git-Implementierungen können Sie diesen Workflow anpassen:

  • Sie können Ihren Entwicklern erlauben, Pull-Anfragen für Ihren Git-Produktionszweig einzureichen, anstatt ihnen zu ermöglichen, ihre Änderungen über die Looker-IDE zusammenzuführen. Weitere Informationen finden Sie auf der Dokumentationsseite Einstellungen für die Projektversion konfigurieren.
  • Sie können im Feld Git Production-Zweigname angeben, welcher Zweig aus Ihrem Git-Repository als Zielzweig verwendet werden soll. Weitere Informationen finden Sie auf der Dokumentationsseite Einstellungen für die Projektversion konfigurieren.
  • Sie können den erweiterten Bereitstellungsmodus verwenden, um ein anderes Commit-SHA- oder Tag-Namen für die Bereitstellung in Ihrer Looker-Produktionsumgebung anzugeben, anstatt den neuesten Commit für den Produktionszweig zu verwenden. Wenn Sie ein Commit aus einem anderen Zweig bereitstellen möchten, können Sie den erweiterten Bereitstellungsmodus Webhook oder API-Endpunkt verwenden. Weitere Informationen finden Sie auf der Dokumentationsseite zum erweiterten Bereitstellungsmodus.

Wenn anstelle der in diesem Abschnitt beschriebenen Optionen die Schaltfläche Git konfigurieren angezeigt wird, müssen Sie zuerst Git für Ihr Projekt einrichten.

Nicht gespeicherte Änderungen ansehen

Die LookML IDE umfasst mehrere Indikatoren, die angezeigt werden, wenn Sie sich im Entwicklungsmodus befinden und nicht zugesicherte Änderungen haben. Dies wird im Abschnitt Hinzufügen, Ändern und Löschen von Markierungen auf der Dokumentationsseite zum Bearbeiten und Validieren von LookML beschrieben.

Sie können eine Unterschiedsübersicht für alle Dateien abrufen. Wählen Sie dazu im Bereich Git Actions (Git-Aktionen) die Option View Commited Commits (Nicht gespeicherte Änderungen ansehen) aus.

Im Fenster Nicht zugesicherte Änderungen am Projekt wird in Looker eine Zusammenfassung aller nicht gespeicherten, gespeicherten Änderungen in allen Projektdateien angezeigt. Für jede Änderung wird in Looker Folgendes angezeigt:

  • Der Name der ersetzten Datei und der Name der hinzugefügten Datei.
    • Der Name der ersetzten Datei (durch --- angegeben) und der Name der hinzugefügten Datei (durch +++ angegeben). In vielen Fällen werden dadurch unterschiedliche Versionen derselben Datei angezeigt. Dabei sind Überarbeitungen mit --- a/ und +++ b/ gekennzeichnet.
    • Gelöschte Dateien werden als Ersatz für eine Nulldatei (+++ /dev/null) angezeigt.
    • Hinzugefügte Dateien werden als Ersatz für eine Nulldatei (--- /dev/null) angezeigt.
  • Die Zeilennummer, mit der die Änderung beginnt.
    Beispiel: -101,4 +101,4 gibt an, dass in der 101. Zeile der Datei 4 Zeilen entfernt und 4 Zeilen hinzugefügt wurden. Eine gelöschte Datei mit 20 Zeilen würde -1,20 +0,0 anzeigen, um anzugeben, dass in der ersten Zeile der Datei 20 Zeilen entfernt und durch Nullzeilen ersetzt wurden.
  • Aktualisierter Text:
    • Gelöschte Zeilen werden rot angezeigt.
    • Hinzugefügte Zeilen werden grün angezeigt.

Wenn Sie eine einzelne Zusammenfassung für eine einzelne Datei aufrufen möchten, wählen Sie im Menü der Datei die Option Änderungen anzeigen aus.

Änderungen übernehmen

Nachdem Sie Änderungen an Ihrem LookML-Projekt vorgenommen und gespeichert haben, müssen Sie möglicherweise Ihr LookML bestätigen. Auf der Git-Schaltfläche wird der Text LookML prüfen in diesem Szenario angezeigt.

Ob dies erforderlich ist, hängt von der Einstellung für die Codequalität des Projekts ab. Weitere Informationen zum Inhaltsvalidierungsprogramm finden Sie auf der Seite LookML validieren.

Wenn ein anderer Entwickler seit der letzten Aktualisierung Ihres lokalen Zweigs Änderungen am Produktionszweig vorgenommen hat, müssen Sie diese Änderungen in Looker aus dem Produktionszweig abrufen. Die Schaltfläche „Git“ zeigt in diesem Fall den Text Pull from Production (Aus Produktion abrufen) an.

Wenn für Ihr Projekt der erweiterte Bereitstellungsmodus aktiviert ist, wird stattdessen die Git-Schaltfläche mit dem Text Pull aus primärem Zweig angezeigt.

Nachdem Sie Ihre Änderungen gespeichert und gegebenenfalls LookML-Warnungen oder -Fehler behoben haben, sofern erforderlich, und sie aus der Produktion beziehen (falls erforderlich), wird auf der Git-Schaltfläche der Text Commit für Änderungen und Übertragung angezeigt.

Wenn Sie möchten, können Sie zuerst die nicht zugesicherten Änderungen überprüfen, bevor Sie sich verpflichten.

Wenn Sie die Änderungen übernehmen möchten, klicken Sie auf die Git-Schaltfläche, um sie für den aktuellen Zweig zu übernehmen. In Looker wird das Dialogfeld Commit angezeigt, in dem die Dateien aufgeführt werden, die hinzugefügt, geändert oder gelöscht wurden.

Geben Sie eine Beschreibung Ihrer Änderungen ein und entfernen Sie die Häkchen neben allen Dateien, die nicht in die Synchronisierung aufgenommen werden sollen. Wählen Sie dann Commit aus, um die Änderungen zu übernehmen.

Prüfung auf nicht erstellte PATs wird durchgeführt

Wenn Sie Änderungen an PDTs in Ihrem Projekt vorgenommen haben, wird empfohlen, alle PDTs bei der Bereitstellung für die Produktion zu erstellen, damit die Tabellen sofort als Produktionsversionen verwendet werden können. Wenn Sie den Status von PATs im Projekt prüfen möchten, klicken Sie auf das Symbol Projektstatus, um den Bereich Projektstatus zu öffnen. Wählen Sie dann die Schaltfläche PDT-Status validieren aus.

Weitere Informationen zur Suche nach nicht erstellten PATs in Ihrem LookML-Projekt und zum Arbeiten mit abgeleiteten Tabellen im Entwicklungsmodus finden Sie auf der Dokumentationsseite Abgeleitete Tabellen in Looker.

Datentests ausführen

Ihr Projekt kann Datentests zur Überprüfung der Logik Ihres LookML-Modells enthalten. Informationen zum Einrichten von Datentests in Ihrem Projekt finden Sie auf der Seite mit der Parameterdokumentation zu test.

Sie müssen sich im Entwicklungsmodus befinden, um Datentests ausführen zu können. Im Entwicklungsmodus gibt es mehrere Möglichkeiten, Datentests für ein Projekt zu starten:

  1. Wenn Ihre Projekteinstellungen so konfiguriert sind, dass Datentests bestanden werden müssen, bevor die Dateien in der Produktion bereitgestellt werden, zeigt die IDE die Schaltfläche Tests ausführen an, nachdem Sie Änderungen per Commit an dem Projekt vorgenommen haben, um alle Tests für Ihr Projekt auszuführen, unabhängig davon, welche Datei den Test definiert. Sie müssen die Datentests bestehen, bevor Sie Ihre Änderungen in der Produktion bereitstellen können.
  2. Wählen Sie im Bereich Projektstatus die Schaltfläche Datentests ausführen aus. Looker führt alle Datentests in Ihrem Projekt aus, unabhängig davon, welche Datei den Test definiert.
  3. Wählen Sie im Menü der Datei die Option LookML-Tests ausführen aus. Looker führt nur die in der aktuellen Datei definierten Tests aus.

Nachdem Sie die Datentests ausgeführt haben, werden im Bereich Projektzustand der Fortschritt und die Ergebnisse angezeigt.

  • Ein Datentest besteht, wenn die Zusicherung des Tests für jede Zeile der Testabfrage wahr ist. Weitere Informationen zum Einrichten von Assertions und -abfragen finden Sie auf der Seite zu den test-Parametern.
  • Wenn ein Datentest fehlschlägt, erhalten Sie im Bereich Projektzustand Informationen dazu, warum der Test fehlgeschlagen ist, ob in der Logik Ihres Modells Fehler aufgetreten sind oder ob der Test selbst ungültig war.
  • Sie können den Namen eines Testes auswählen, um direkt zu LookML für den Datentest zu gelangen. Alternativ können Sie auch auf die Schaltfläche Erkunden klicken, um die Abfrage mit der im Datentest definierten Abfrage zu öffnen.

In der Produktion bereitstellen

Sobald Sie für den Zweig Änderungen übernommen haben, werden Sie in der Looker-IDE aufgefordert, die Änderungen mit dem primären Zweig zusammenzuführen. Welche Art von Aufforderung Sie in der IDE sehen, hängt von der Konfiguration Ihres Projekts ab:

  • Wenn Ihr Projekt für den erweiterten Bereitstellungsmodus konfiguriert ist, werden Sie in der IDE aufgefordert, Ihre Änderungen mit dem primären Zweig zusammenzuführen. Nachdem Sie den Commit zusammengeführt haben, kann ein Looker-Entwickler mit der Berechtigung deploy das Commit für die Produktion mit dem Looker IDE Deployment Manager oder mit einem Webhook oder einem API-Endpunkt bereitstellen.
  • Wenn Ihr Projekt für die Git-Integration mit Pull-Anfragen konfiguriert ist, werden Sie aufgefordert, eine Pull-Anfrage über die Schnittstelle Ihres Git-Anbieters zu öffnen.
  • Ohne die deployBerechtigung werden Sie bei der Standard-Looker-Git-Einbindung Ihre Änderungen mit dem Produktionszweig zusammengeführt und in der Produktionsversion Ihrer Looker-Instanz bereitgestellt.

Erweiterter Bereitstellungsmodus

Bei der standardmäßigen Looker-Git-Integration übernehmen Looker-Entwickler ihre Änderungen in ihren Entwicklungszweig und führen dann ihren Entwicklungszweig mit dem Produktionszweig zusammen. Bei der Bereitstellung in der Looker-Umgebung verwendet Looker dann den neuesten Commit für den Produktionszweig. Im Abschnitt Änderungen an der Produktion abrufen auf dieser Seite finden Sie den Standardgit-Workflow und andere Optionen für erweiterte Git-Implementierungen.

Wenn Sie nicht möchten, dass immer der neueste Commit für den Produktionszweig für Ihre Looker-Umgebung verwendet wird, kann ein Entwickler mit deploy-Berechtigung den erweiterten Bereitstellungsmodus verwenden, um das genaue Commit für Ihre Looker-Umgebung zu verwenden. Das ist in Entwickler-Workflows mit mehreren Umgebungen nützlich, in denen jede Umgebung auf eine andere Version einer Codebasis verweist. Außerdem geben Sie einem oder mehreren Entwicklern oder Administratoren mehr Kontrolle über die Änderungen, die in der Produktion bereitgestellt werden.

Wenn der erweiterte Bereitstellungsmodus aktiviert ist, werden Entwickler in der Looker-IDE nicht aufgefordert, ihre Änderungen in der Produktionsumgebung bereitzustellen. Stattdessen werden Entwickler durch die IDE dazu aufgefordert, ihre Änderungen mit dem Produktionszweig zusammenzuführen. Von dort aus können Änderungen nur auf folgende Arten bereitgestellt werden:

  • Deployment Manager in der Looker-IDE verwenden
  • Webhook auslösen

  • API-Endpunkt verwenden

Weitere Informationen finden Sie auf der Dokumentationsseite zum erweiterten Bereitstellungsmodus.

Auswirkungen der Änderungen prüfen

Nachdem Sie die Änderungen für die Organisation verfügbar gemacht haben, können Sie mithilfe der Inhaltsvalidierung prüfen, ob Sie Dashboards oder gespeicherte Looks ungültig gemacht haben. Sie haben die Möglichkeit, das Problem zu beheben.

Umgang mit typischen Problemen

Während Sie an Ihrem Modell arbeiten, müssen Sie möglicherweise Folgendes tun:

  • Änderungen verwerfen

    Gelegentlich kann es sinnvoll sein, Ihre Datenmodellierungsänderungen zu verwerfen. Wenn sie noch nicht gespeichert wurden, können Sie die Seite einfach aktualisieren oder die Seite verlassen und dann die Warnmeldung akzeptieren. Wenn Sie die Änderungen gespeichert haben, können Sie die nicht vorgenommenen Änderungen rückgängig machen, wie im Abschnitt Nicht zugesicherte Änderungen rückgängig machen beschrieben.

  • Umgang mit Konflikten bei der Zusammenarbeit mit anderen Entwicklern

    Wenn mehrere Entwickler an Ihrem Datenmodell arbeiten, übernimmt Git normalerweise die Situation. Manchmal braucht es jedoch einen Menschen, um Konflikte zu lösen.

Einige Änderungen, z. B. der Name eines Felds, können sich auf bestehende Dashboards und das Design auswirken. Wie bereits erwähnt, können Sie Ihre Inhalte mithilfe der Inhaltsvalidierung prüfen und Probleme beheben, nachdem sie für Ihre Organisation verfügbar gemacht wurden.

Nicht zugesicherte Änderungen rückgängig machen

Wenn Sie Ihre zweige Entwicklungsabteilung bearbeiten, können Sie ungesicherte Änderungen rückgängig machen, die Sie nicht bereitstellen möchten. Sie können alle nicht vorgenommenen Änderungen für alle Dateien im Projekt oder nur die Änderungen in einer einzelnen Datei rückgängig machen.

So heben Sie die Änderungen ohne Zusicherung für alle Dateien auf:

  1. Wählen Sie im Bereich Git Actions (Git-Aktionen) die Option Rückgängig machen... aus.
  2. Wählen Sie eine Wiederherstellungsoption aus:
    • Wenn Sie nur nicht zugewiesene Änderungen rückgängig machen möchten, wählen Sie Nicht zugesicherte Änderungen rückgängig machen aus. Sie können auch den Link Änderungen anzeigen auswählen, um die Änderungen anzuzeigen, die rückgängig gemacht werden würden.
    • Wenn Sie alle Änderungen rückgängig machen möchten, einschließlich der nicht zugesicherten und zugesicherten Änderungen, wählen Sie Produktion wiederherstellen aus.
  3. Wählen Sie zum Bestätigen Bestätigen aus.

Wenn Sie das Hinzufügen oder Löschen von Inhalten einer Datei rückgängig machen möchten, wählen Sie im Menü der Datei die Option Änderungen rückgängig machen aus:

Wenn Sie eine Datei umbenennen, löschen Sie im Wesentlichen die Originaldatei und erstellen eine neue Datei mit einem neuen Namen. Da dies mehr als eine Datei umfasst, lässt sich die Umbenennung der Datei nicht mithilfe der Option Datei rückgängig machen rückgängig machen. Wenn Sie eine Datei umbenennen möchten, verwenden Sie die Option Zurücksetzen auf... im Bereich Git Actions (Git-Aktionen).

Wenn Sie eine Datei gelöscht haben, wird sie auch nicht mehr im IDE-Dateibrowser angezeigt. Wenn Sie eine gelöschte Datei wiederherstellen möchten, verwenden Sie im Bereich Git Actions (Git-Aktionen) die Option Rückgängig machen....

Zusammenführungskonflikte lösen

Normalerweise kann Git Ihre neuen Änderungen automatisch mit der Produktionsversion Ihrer LookML-Dateien zusammenführen. Ein Merge-Konflikt tritt auf, wenn Git in Konflikt stehende Änderungen feststellt und nicht ermittelt werden kann, welche Änderungen beibehalten werden sollen. Dies ist in der Regel dann der Fall, wenn ein anderer Entwickler Änderungen vorgenommen hat, seit Sie das letzte Mal Änderungen vorgenommen haben und Sie Änderungen im selben Bereich vorgenommen haben. Wenn in Ihrem Code ein Merge-Konflikt vorliegt, wird in Looker die Warnung Merge-Konflikt angezeigt, nachdem Sie einen Commit für die Änderungen durchgeführt haben und aus der Produktion stammen.

Wenn in Looker die Warnung zum Zusammenführen von Konflikten angezeigt wird, empfehlen wir Ihnen, den Zusammenführungskonflikt zu beheben, bevor Sie weitere Änderungen vornehmen. Das Zusammenführen eines Konflikts mit der Produktion führt zu Parsing-Fehlern, die die Untersuchung Ihrer Daten verhindern können. Wenn Sie ein erfahrener Git-Nutzer sind und mit dem Übertragen von Änderungen fortfahren möchten, wählen Sie die Schaltfläche Nicht beheben aus.

In der LookML-Datei selbst sind die Zeilen mit Konflikten so gekennzeichnet:

<<<<<<< HEAD
Your code
&#61;&#61;&#61;&#61;&#61;&#61;&#61;
Production code
>>>>>>> branch 'master'

In Looker werden die folgenden Zusammenführungsmarkierungen angezeigt, um auf diese Zusammenführung hinzuweisen:

  • <<<<<< HEAD markiert den Anfang der in Konflikt stehenden Zeilen.
  • Mit >>>>>>> branch 'master' wird das Ende der in Konflikt stehenden Zeilen angegeben.
  • Mit ====== werden die einzelnen Versionen des Codes voneinander getrennt, damit Sie sie vergleichen können.

Im vorherigen Beispiel steht your code für die übernommenen Änderungen und production code für den Code, mit dem Ihre Änderungen durch Git nicht automatisch zusammengeführt werden konnten.

So beheben Sie einen Konflikt der Zusammenführung:

  1. Findet Dateien mit Konflikten bei der Zusammenführung Looker markiert diese Dateien rot. Sie können auch in Ihrem Projekt nach Zusammenführungen suchen, z. B. <<<< oder HEAD, um nach allen Konflikten in Ihrem Projekt zu suchen. Sie können die betroffenen Dateien auch finden, indem Sie im Bereich Git Actions (Git-Aktionen) den Link files (Dateien) auswählen.
  2. Gehen Sie in der Datei zu den Zeilen mit Konflikten bei der Zusammenführung und löschen Sie die Version des Texts, die Sie NICHT beibehalten möchten. Löschen Sie auch alle Markierungen zum Zusammenführen von Konflikten.

  3. Speichern Sie die Datei und wiederholen Sie die vorherigen Schritte für alle Dateien, die mit Zusammenstellungskonflikten markiert wurden.

  4. Nachdem Sie alle Zusammenführungskonflikte behoben und alle Zusammenführungsmarkierungen aus Ihrem Projekt gelöscht haben, beauftragen Sie die Änderungenund bereits in der Produktion bereitstellen.

Nachdem Sie den Zusammenführungskonflikt behoben und Ihre Lösung auf die Produktion übertragen haben, können andere Entwickler die Produktionsversion verwenden und wie gewohnt weiterarbeiten.

automatische Speicherbereinigung für Git-Geräte

Durch die automatische Speicherbereinigung werden unnötige Dateien bereinigt und Dateiüberarbeitungen komprimiert, um Ihr Git-Repository zu optimieren. Die automatische Speicherbereinigung für Git (git gc) wird automatisch ausgeführt, wenn Ihre Looker-Instanz aktualisiert oder neu gestartet wird. Damit git gc nicht zu oft ausgeführt wird, wartet Looker 30 Tage seit der letzten git gc und führt dann git gc beim nächsten Neustart aus.

In seltenen Fällen können Sie versuchen, Änderungen an die Fernbedienung zu übertragen oder Zweig an Fernbedienung zu senden, während git gc ausgeführt wird. Wenn in Looker ein Fehler angezeigt wird, warten Sie ein bis zwei Minuten und versuchen Sie es dann noch einmal.