Looker IDE – Übersicht

Die Looker-IDE (Integrated Development Environment, integrierte Entwicklungsumgebung) bietet Zugriff auf Ihre LookML-Projektdateien und die Einstellungen für Ihr LookML-Projekt.

Zugriff auf die Looker IDE

Damit Sie ein LookML-Projekt sehen können, benötigen Sie die Berechtigung develop für mindestens ein Modell im Projekt. Sie können über das Steuerfeld Entwickeln im Hauptnavigationsmenü von Looker auf die Looker-IDE zugreifen:

  1. Wählen Sie im Navigationsbereich Entwickeln aus, um den Bereich Entwickeln zu öffnen.
  2. Wählen Sie im Bereich Entwickeln den Namen des Projekts aus, auf das Sie zugreifen möchten.

Looker öffnet die IDE für das ausgewählte LookML-Projekt.

Alternativ können Sie die IDE für bestimmte LookML-Objekte über ein Explore oder über den Objektbrowser öffnen. Weitere Informationen und Optionen finden Sie unter Auf Projektdateien zugreifen.

Elemente der Looker IDE

Die Looker-IDE umfasst die folgenden Elemente:

  1. Banner für den Entwicklungsmodus: Dieses Banner gibt an, dass Sie sich im Entwicklungsmodus befinden. Dort können Sie Änderungen an LookML-Dateien vornehmen und sich in der Vorschau ansehen, wie sich diese auf die Inhalte in Ihrer Instanz auswirken. Sie können im Banner auf den Link Entwicklungsmodus beenden klicken, um in den Produktionsmodus zu wechseln.
  2. Navigationsleiste der IDE: Über die Navigationsleiste können Sie auf verschiedene Funktionen der Looker-IDE zugreifen. Einige Funktionen sind nur im Entwicklungsmodus verfügbar. Nachdem Sie eine Funktion in der Navigationsleiste der IDE ausgewählt haben, können Sie das Navigationsleistenelement noch einmal auswählen, um den Funktionsbereich einzuklappen. Über die Navigationsleiste der IDE können Sie auf die folgenden IDE-Funktionen zugreifen:
    • Dateibrowser: Hiermit wird der Dateibrowser geöffnet, über den Sie auf die Dateien und Ordner in Ihrem LookML-Projekt zugreifen können.
    • Objektbrowser: Hiermit wird der Objektbrowser geöffnet, in dem die LookML-Objekte in Ihrem Projekt und die hierarchischen Beziehungen zwischen den Objekten angezeigt werden.
    • Suchen und ersetzen: Daraufhin wird die Seite Im Projekt suchen und ersetzen angezeigt. Dort können Sie in allen Projektdateien nach Text suchen und dann alle oder ausgewählte Instanzen in einem Bulk-Vorgang ersetzen.
    • Git-Aktionen: (Nur im Entwicklungsmodus sichtbar) Hier werden die Git-Zweigstellen Ihres Projekts und die Git-Befehle angezeigt, die für Ihren Git-Zweig des Projekts verfügbar sind. Auf der Seite Versionskontrolle und Bereitstellung verwenden finden Sie Informationen zur Verwendung von Git mit Ihrem LookML-Projekt.
    • Einstellungen: (Nur im Entwicklungsmodus sichtbar) Hier werden die Seiten mit den Projekteinstellungen für Ihr Projekt angezeigt. Dort können Sie Optionen für die Versionskontrolle des Projekts, Anmeldedaten für importierte Projekte, von Ihrem Projekt verwendete Git-Branches und IDE-Einstellungen konfigurieren.
    • Bereitstellen: (Nur im Entwicklungsmodus sichtbar) Bei Projekten, die mit dem erweiterten Bereitstellungsmodus eingerichtet sind, wird der Deployment Manager geöffnet. Dort können Entwickler mit der Berechtigung deploy ein Commit oder Tag in ihrer Looker-Produktionsumgebung bereitstellen.
  3. Steuerfeld: Bietet Navigation für LookML-Dateien und -Objekte für den Datei- und Objektbrowser, Suchparameter für die Such- und Ersetzen-Funktion, verfügbare Git-Befehle für das Steuerfeld Git-Aktionen und Tabs für den Zugriff auf verschiedene Einstellungen für das Steuerfeld „Projekteinstellungen“.
  4. IDE-Editorbereich: Der Editor für LookML-Dateien. Der Editor wird angezeigt, wenn in der Navigationsleiste der IDE File Browser (Dateibrowser) oder Object Browser (Objektbrowser) ausgewählt ist. Weitere Informationen zum Editor finden Sie unter Bearbeitungsfunktionen der Looker IDE.
  5. Seitenleistenauswahl: Klicken Sie auf eine Option, um die Funktionen der IDE-Seitenleiste zu öffnen:
    • Projektstatus: Hiermit wird der Bereich Projektstatus geöffnet.
    • Soforthilfe: Hier wird der Bereich Soforthilfe geöffnet. Er enthält einen Tab, über den Sie den Bereich Metadaten aufrufen können.
    • Hilf mir beim Programmieren: (Für Looker (Google Cloud Core)-Instanzen mit aktiviertem Gemini) Hiermit wird das Steuerfeld Hilf mir beim Programmieren geöffnet. Klicken Sie noch einmal auf die Auswahloption für die Seitenleiste, um sie auszublenden.
  6. Seitenleiste der IDE: Hier wird die ausgewählte Seitenleistenfunktion angezeigt:
  7. Git-Schaltfläche: Je nach Status Ihres Projekts wird auf der Schaltfläche die nächste Aktion angezeigt, die Sie ausführen sollten, um Ihr Projekt in die Produktion zu bringen, z. B. LookML validieren, Branch auf Remote-Server pushen oder Commit. Klicken Sie auf die Schaltfläche, um die Aktion auszuführen. In der Git-Befehlsreferenz finden Sie eine Liste der möglichen Befehle, die über die Schaltfläche angezeigt und ausgeführt werden können.

Looker IDE einrichten

Sie haben folgende Möglichkeiten, die Looker IDE anzupassen:

Modi des Texteditors

Die Looker-IDE unterstützt drei Texteditormodi:

  • Looker IDE-Editor (Standard)
  • Vim
  • Emacs

So ändern Sie den Modus des Texteditors:

  1. Klicken Sie in der Looker-IDE im linken Navigationsbereich auf das Symbol Einstellungen.
  2. Wählen Sie in den IDE-Einstellungen den Tab Editor aus.
  3. Wählen Sie im Drop-down-Menü Texteditor-Modus die gewünschte Option aus.

Sobald Sie eine Option aus dem Drop-down-Menü ausgewählt haben, wird die Looker-IDE sofort so aktualisiert, dass der ausgewählte Texteditormodus verwendet wird.

Modus „Zeilenumbruch“

In der Looker-IDE ist standardmäßig das Umbrechen von Zeilen aktiviert.

So aktivieren oder deaktivieren Sie den Zeilenumbruch:

  1. Klicken Sie in der Looker-IDE im linken Navigationsbereich auf das Symbol Einstellungen.
  2. Wählen Sie in den IDE-Einstellungen den Tab Editor aus.
  3. Mit dem Schalter Zeilenumbruchmodus können Sie den Zeilenumbruch in der IDE aktivieren oder deaktivieren.

Sobald Sie die Option aktiviert haben, wird die Aktualisierung auf die Looker-IDE angewendet.

Seitenleisten der IDE anpassen

Sie können die Breite der Bereiche in der IDE ändern, sowohl den Bereich „Funktionen“ (mit den Bereichen Dateibrowser, Objekt-Browser und Git-Aktionen) als auch die Seitenleiste (mit den Bereichen Projektstatus, Schnellhilfe und Metadaten).

Wenn Sie die Größe der IDE-Bereiche ändern möchten, bewegen Sie den Mauszeiger auf den Rahmen des Bereichs und ziehen Sie ihn dann, um die Größe zu ändern:

Wenn Sie sich im Entwicklungsmodus befinden, wird die Größe der Seitenleisten in der IDE beibehalten, unabhängig von Anmeldungen und Aktualisierungen.

Seitenleisten der IDE minimieren

Wenn Sie die Breite des IDE-Bearbeitungsfelds maximieren möchten, können Sie die Seitenleisten der IDE minimieren:

  • Sie können den Bereich „IDE-Funktionen“ entweder mit der Tastenkombination „Befehlstaste + B“ (Mac) oder „Strg + B“ (Windows) ein- oder ausblenden oder auf ein bereits ausgewähltes Symbol in der Navigationsleiste der IDE klicken.
  • Wenn Sie die Seitenleiste der IDE ein- oder ausblenden möchten, klicken Sie auf ein bereits ausgewähltes Symbol in der Auswahl für die Seitenleiste.

Bearbeitungsfunktionen der Looker IDE

In den folgenden Abschnitten werden einige der Bearbeitungsfunktionen der Looker IDE beschrieben, die Ihnen bei der Entwicklung in LookML helfen können:

Autosuggest

Während Sie tippen, schlägt die IDE mögliche Parameter und Werte vor, die auf den Kontext Ihrer Eingabe bezogen sind. Die Vorschläge für den Parameter type einer Dimension enthalten beispielsweise nur gültige Optionen für diesen Parameter. Außerdem müssen Felder in sql-Parametern mit ${...} gekennzeichnet sein. Die IDE fügt diese Syntax daher hinzu, wenn Felder vorgeschlagen werden.

Die automatische Vervollständigung wird automatisch angezeigt, wenn sie angezeigt werden kann. Drücken Sie zum Schließen die Esc-Taste auf der Tastatur. Wenn Sie sie jederzeit aufrufen möchten, drücken Sie Strg + Leertaste (Windows) oder ⌘ + Leertaste (Mac).

Ad-hoc-Fehlerprüfung

Die IDE erkennt Syntaxfehler während der Eingabe. Ein rotes X im Bereich für Ränder weist auf einen Syntaxfehler hin, der rot unterstrichen ist. Wenn Sie den Mauszeiger auf das rote X bewegen, wird eine kurze Beschreibung des Problems angezeigt. Wenn Sie beispielsweise fälschlicherweise avrage anstelle von average als Wert für den Parameter type für ein Messwert eingeben, wird in der IDE der Fehler Invalid value for "type":avrage angezeigt.

Der LookML-Validator ist weiterhin erforderlich, um eine vollständige Modellvalidierung durchzuführen. Einige Fehler, z. B. eine ungültige Feldreferenz, die durch einen fehlenden Join verursacht wird, erfordern einen ganzheitlichen Blick auf das Modell und werden daher nur angezeigt, wenn der LookML-Validator ausgeführt wird.

Automatische Formatierung

Im Entwicklungsmodus können Sie die Tastenkombination zum Formatieren von Dateien verwenden, um Ihre LookML-Datei automatisch einzurücken. Die Einzüge geben die Hierarchie von Parametern und Unterparametern an, wodurch Ihre LookML-Anweisungen leichter zu lesen und zu verstehen sind.

Zusammenklappbar

In der linken Ränderleiste wird neben dem Anfang jedes LookML-Parameters der obersten Ebene in der Datei ein kleiner Pfeil angezeigt. Wenn Sie diesen Pfeil auswählen, wird der entsprechende LookML-Abschnitt minimiert oder maximiert, damit Sie sich nur auf bestimmte Bereiche konzentrieren können.

Das Menü Dateiaktionen ansehen für die LookML-Datei enthält auch die Optionen LookML minimieren und LookML maximieren, mit denen Sie alle LookML-Abschnitte bis zum Parameter der obersten Ebene in der aktuellen Datei maximieren oder minimieren können.

Sie können LookML auch mit Tastenkombinationen minimieren und maximieren.

Kommentieren

Sie können Ihrer LookML Kommentare hinzufügen, um sie besser lesbar zu machen. Wenn du einen einzelnen Kommentar hinzufügen möchtest, verwende das Zeichen #:

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

So können Sie einen ganzen Codeblock mit Tastenkombinationen kommentieren:

  1. Wählen Sie die Zeilen aus, die Sie auskommentieren möchten.
  2. Drücken Sie Befehlstaste + / (Mac) oder Strg + / (Windows).

In der IDE wird allen ausgewählten Zeilen das Zeichen # hinzugefügt.

SQL-Blöcke auskommentieren

Wenn Sie Zeilen auskommentieren, die sich vollständig in einem SQL-Codeblock befinden, fügen Sie manuell eine SQL-Kommentarnotation hinzu.

Wenn Sie den SQL-Kommentarblock verwenden, werden die kommentierten Abschnitte weiterhin als LookML-Code interpretiert. Daher werden Ihre Kommentare in LookML-generiertem SQL angezeigt, haben aber keinen Einfluss auf die Abfrageergebnisse.

Hinzugefügte, geänderte und gelöschte Elemente ansehen

In der LookML-IDE werden immer mehrere Indikatoren angezeigt, wenn Sie sich im Entwicklungsmodus befinden und nicht übernommene Änderungen vorhanden sind.

  • Der Name der Datei wird links im Fenster mit einem blauen Punkt angezeigt, um anzugeben, dass die Datei neu, geändert oder umbenannt wurde.
  • Wenn Sie eine neue oder geänderte Datei öffnen, werden die Zeilennummern in der Datei grün hervorgehoben, um neue oder geänderte Zeilen anzuzeigen. Eine horizontale rote Linie kennzeichnet entfernte Zeilen.

Persistenz des IDE-Status

Wenn Sie sich im Entwicklungsmodus befinden, speichert die Looker IDE Ihren IDE-Status bei Aktualisierungen und Anmeldungen. Der IDE-Status enthält Folgendes:

  • Das ausgewählte Element in der Navigationsleiste der IDE (z. B. der Dateibrowser, Git-Aktionen, der Objektbrowser oder die Projekteinstellungen)
  • LookML-Datei öffnen, die im Dateibrowser angezeigt wird
  • Maximierter oder minimierter Zustand von Elementen im Datei- und Objektbrowser
  • Breite der Seitenleisten der IDE
  • Das ausgewählte Element in der rechten Seitenleiste der IDE, z. B. das Steuerfeld „Soforthilfe“, das Steuerfeld „Metadaten“ und das Steuerfeld „Projektstatus“
  • Der Zeilenumbruchmodus des Editors

Wenn Sie die IDE auf die Standardeinstellungen zurücksetzen möchten, klicken Sie im linken Navigationsbereich der Looker-IDE auf das Symbol Einstellungen, wählen Sie im Bereich IDE-Einstellungen den Tab Editor aus und klicken Sie dann auf die Schaltfläche IDE-Layout zurücksetzen. Die IDE speichert Ihren Status wieder, wenn Sie Dateien öffnen und Auswahlen treffen.

Zu Objekt oder Datei springen

In der Looker IDE können Sie mit der Funktion Zu Objekt oder Datei springen eine Schnellsuche durchführen, um direkt zu LookML-Objekten und Projektdateien zu gelangen. Klicken Sie im Dateibrowser oder im Objektbrowser auf das Symbol Zu Objekt oder Datei springen oder verwenden Sie die Tastenkombination Befehlstaste-J (Mac) oder Strg-J (Windows).

Weitere Informationen finden Sie auf der Dokumentationsseite Auf LookML-Projektdateien zugreifen.

Soforthilfe

Wählen Sie das Symbol Soforthilfe aus, um den Bereich Soforthilfe zu öffnen. Dort finden Sie Erläuterungen und Optionen für den aktuellen Codeabschnitt. Wählen Sie in der Seitenleiste einen Parameternamen aus, um die Looker-Dokumentationsseite für diesen Parameter zu öffnen.

Bereich „Hilfe beim Programmieren“

Wenn Sie eine Looker (Google Cloud Core)-Instanz mit aktiviertem Gemini haben, können Sie Gemini in Looker verwenden, um LookML zu schreiben:

Looker IDE mit hervorgehobenem Symbol „Hilfe beim Programmieren“

Weitere Informationen finden Sie in der Dokumentation LookML mit Gemini in Looker-Unterstützung schreiben.

Optionsmenüs für Dateien und Ordner

Im Dateibrowser hat jede Datei oder jeder Ordner im linken Bereich ein Menü mit den verfügbaren Aktionen für das jeweilige Element. Bewegen Sie den Cursor auf eine Datei oder einen Ordner und klicken Sie dann auf das Dreipunkt-Menü Ordneroptionen (für Ordner) oder Dateioptionen (für Dateien), um das Menü zu öffnen. Wenn ein Element einen langen Namen hat oder in mehreren Ordnern verschachtelt ist, können Sie im Dateibrowser-Bereich seitlich scrollen, um auf das Menü zuzugreifen.

Über die Optionsmenüs können Sie Ordner und Dateien erstellen, Dateien hochladen und Dateien und Ordner über den Dateibrowser löschen und verschieben. Weitere Informationen finden Sie auf der Seite LookML-Dateien und ‑Ordner verwalten.

Wenn Sie Ihre LookML-Dateien in Ordnern organisieren, müssen Sie Ihre Änderungen committen und in der Produktion bereitstellen, damit andere Looker-Entwickler sie sehen können. Das funktioniert genauso wie bei jeder anderen Änderung an Ihrem LookML-Projekt.

Text in einem Projekt suchen und ersetzen

Die Looker-IDE bietet eine Such- und Ersetzungsfunktion, mit der Sie in allen Projektdateien nach Text suchen und dann alle oder ausgewählte Instanzen in einem Bulk-Vorgang ersetzen können.

So verwenden Sie die Suchfunktion der Looker IDE:

  1. Rufen Sie in der IDE das Suchfeld auf.
  2. Geben Sie einen Begriff in das Feld Suchen ein.
  3. Optional können Sie Groß- und Kleinschreibung berücksichtigen auswählen, um nur nach Instanzen zu suchen, die mit der Groß- und Kleinschreibung übereinstimmen, die Sie im Feld Suchen eingegeben haben. Sie können auch RegEX auswählen, um eine Suche mit regulären Ausdrücken durchzuführen.
  4. Wählen Sie Suchen aus.
  5. Optional können Sie den Namen einer Datei auswählen, um sie in der IDE zu öffnen.

Wenn Sie sich im Entwicklungsmodus befinden, wird auch das Feld Ersetzen durch angezeigt. So ersetzen Sie Text in Ihrem Projekt:

  1. Geben Sie im Feld Ersetzen durch den Ersatztext ein. Optional können Sie das Feld Ersetzen durch leer lassen, wenn Sie den Text im Feld Suchen löschen möchten, anstatt ihn zu ersetzen.

  2. Wähle Auswählen und ersetzen aus, um eine Vorschau zu sehen, wie der Text in deinem Projekt ersetzt wird.

  3. In den Ergebnissen werden alle Instanzen in Ihrem Projekt angezeigt, die ersetzt werden sollen. Mit den folgenden Optionen können Sie anpassen, welche Instanzen ersetzt werden:

    • Mit dem Kästchen neben der Zusammenfassung der Ergebnisse können Sie alle Instanzen in Ihrem gesamten Projekt auswählen oder die Auswahl aufheben.
    • Klicken Sie das Kästchen neben einer einzelnen Instanz an, um sie auszuwählen oder die Auswahl aufzuheben.

  4. Klicken Sie auf die Schaltfläche Ausgewählte ersetzen, um den Ersatz auf die ausgewählten Instanzen anzuwenden. In der IDE werden die vorgenommenen Änderungen angezeigt.

Neue Felder erstellen und testen

Als Beispiel für die Bearbeitung von LookML fügen wir mehrere Felder hinzu und testen sie dann.

Dimension erstellen

Fügen wir zuerst unserer users-Ansicht eine neue Dimension hinzu, mit der ermittelt wird, ob ein Nutzer aus Kalifornien oder New York stammt. Die Dimension ist type: yesno. Das bedeutet, dass Ja zurückgegeben wird, wenn der Nutzer aus Kalifornien oder New York stammt, und Nein, wenn nicht.

Die LookML für unsere neue Dimension sieht so aus:

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Fügen Sie diese Dimension der Datei „user“ hinzu und klicken Sie dann in der Datei auf die Schaltfläche Änderungen speichern.

Weitere Informationen zu ${TABLE}.state finden Sie unter Ersetzungsoperatoren.

Messwert erstellen

Als Nächstes fügen wir der Ansicht user ein neues Messwert hinzu, mit dem das Durchschnittsalter unserer Nutzer ermittelt wird. Dieser Messwert ist type: average und wird über die Spalte age zusammengefasst.

Die LookML für diesen neuen Messwert sieht so aus:

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Fügen Sie dieses Messwert in die Datei der user-Ansicht ein und klicken Sie dann in der Datei auf die Schaltfläche Änderungen speichern.

Felder im Explore testen

Sie können die neue Dimension und den neuen Messwert testen, indem Sie Abfragen dazu stellen. Nachdem Sie die Änderungen gespeichert haben, werden diese Felder im Feldauswahltool in der explorativen Datenanalyse angezeigt. Über das Drop-down-Menü Dateiaktionen ansehen neben dem Dateinamen der Ansicht können Sie auf die explorative Datenanalyse für die aktuelle Ansicht zugreifen. Im Drop-down-Menü Dateiaktionen ansehen sind alle Explores aufgeführt, die auf der Ansicht basieren, einschließlich Explores, mit denen die Ansicht verknüpft ist. Wenn Sie beispielsweise die explorative Datenanalyse für eine Ansicht namens users aufrufen möchten, können Sie im Drop-down-Menü Dateiaktionen ansehen die Option Nutzer analysieren auswählen.

Im explorativen Analysetool Nutzer können Sie die neuen Felder auswählen, um sie einer Abfrage hinzuzufügen. Sie können beispielsweise eine Abfrage mit beiden neuen Feldern erstellen, die das durchschnittliche Alter der Nutzer in Kalifornien oder New York und das durchschnittliche Alter der Nutzer außerhalb dieser Bundesstaaten anzeigt:

Datentabelle für eine Beispiel-explorative Datenanalyse vom Typ „Nutzer“ mit den ausgewählten Feldern „Nutzer aus CA oder NY (Ja/Nein)“ und „Durchschnittliches Alter der Nutzer“.