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 den Bereich Develop des Looker-Hauptmenüs 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 Develop (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 öffnen, um bestimmte LookML-Objekte über ein Explore oder über den Objektbrowser zu öffnen. Weitere Informationen und andere Optionen finden Sie unter Auf Projektdateien zugreifen.

Elemente der Looker IDE

Die Looker IDE enthält 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 dieser Funktionen sind nur im Entwicklungsmodus verfügbar. Nachdem Sie eine Funktion aus der IDE-Navigationsleiste ausgewählt haben, können Sie das Navigationsleistenelement ein zweites Mal auswählen, um den Funktionsbereich zu minimieren. Über die Navigationsleiste der IDE können Sie auf die folgenden IDE-Funktionen zugreifen:
    • Dateibrowser: Öffnet den Dateibrowser, mit dem Sie auf die Dateien und Ordner in Ihrem LookML-Projekt zugreifen können.
    • Objektbrowser: Öffnet den Objektbrowser, 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-Branches Ihres Projekts und die Git-Befehle angezeigt, die für Ihren Git-Branch 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) Zeigt die Projekteinstellungsseiten für Ihr Projekt an, auf denen Sie Optionen für die Projektversionsverwaltung, Authentifizierungsdaten für importierte Projekte, von Ihrem Projekt verwendete Git-Zweige und IDE-Einstellungen konfigurieren können.
    • 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 Seitenleisten-Funktionen von IDE zu öffnen:
    • Projektstatus: Hier wird der Bereich Projektstatus geöffnet.
    • Soforthilfe: Öffnet den Bereich Soforthilfe, der einen Tab für den Zugriff auf den Bereich Metadaten enthält.
    • Hilfe beim Coden: (Für Looker (Google Cloud Core)-Instanzen mit aktiviertem Gemini) Hiermit wird das Steuerfeld Hilfe beim Coden geöffnet. Klicken Sie noch einmal auf die Auswahloption für die Seitenleiste, um sie auszublenden.
  6. IDE-Seitenleiste: Zeigt die ausgewählte Funktion in der Seitenleiste an:
  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 können die Looker-IDE so anpassen:

Modi des Texteditors

Die Looker-IDE unterstützt drei Texteditormodi:

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

So ändern Sie den Texteditormodus:

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

Sobald Sie eine Option aus dem Pulldown-Menü auswählen, wird die Looker-IDE sofort aktualisiert und verwendet den ausgewählten Texteditormodus.

Modus „Zeilenumbruch“

In der Looker-IDE ist standardmäßig der Zeilenumbruch aktiviert.

So aktivieren oder deaktivieren Sie den Zeilenumbruch:

  1. Wählen Sie im linken Navigationsbereich der Looker-IDE das Symbol Einstellungen aus.
  2. Wählen Sie in den IDE-Einstellungen den Tab Editor aus.
  3. Mit der Ein/Aus-Schaltfläche 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 das Steuerfeld mit den Funktionen, das die Bereiche File Browser, Object Browser und Git Actions enthält, als auch die Seitenleiste mit den Bereichen Project Health, Quick Help und Metadata.

Wenn Sie die Größe der IDE-Steuerfelder anpassen möchten, bewegen Sie den Mauszeiger auf den Rahmen des Steuerfelds und ziehen Sie:

Wenn Sie sich im Entwicklungsmodus befinden, behält die IDE die Größe der Seitenleisten bei Anmeldungen und Aktualisierungen bei.

Seitenleisten der IDE minimieren

Wenn Sie die Breite des IDE-Editorbereichs maximieren möchten, können Sie die IDE-Seitenbereiche 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 Symbol in der Auswahl für die Seitenleiste, das bereits ausgewählt ist.

Bearbeitungsfunktionen der Looker IDE

In den folgenden Abschnitten werden einige der Bearbeitungsfunktionen der Looker-IDE beschrieben, die Sie bei der Entwicklung in LookML unterstützen 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. Diese Syntax fügt die IDE 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 ihn jederzeit aufrufen möchten, drücken Sie Strg + Leertaste (Windows) oder ⌘ + Leertaste (Mac).

Ad-hoc-Fehlerprüfung

Die IDE fängt Syntaxfehler während der Eingabe ab. 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 dennoch 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 das Tastenkürzel zum Formatieren 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.

Im Menü Dateiaktionen ansehen für die LookML-Datei finden Sie außerdem die Optionen LookML aufklappen und LookML aufklappen, um alle LookML-Abschnitte bis zum Parameter der obersten Ebene in der aktuellen Datei zu maximieren oder zu minimieren.

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
}

Mithilfe von Tastenkombinationen können Sie einen ganzen Codeblock auskommentieren. Gehen Sie dazu so vor:

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

Die IDE fügt jeder der ausgewählten Zeilen das Zeichen # hinzu.

SQL-Blöcke kommentieren

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

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

Hinzufügungen, Änderungen und Löschungen sehen

In der LookML-IDE werden immer mehrere Indikatoren angezeigt, wenn Sie sich im Entwicklungsmodus befinden und Änderungen ohne Commit vorgenommen wurden.

  • Der Dateiname wird mit einem blauen Punkt auf der linken Seite des Fensters angezeigt. Dieser weist darauf hin, dass die Datei neu, geändert oder umbenannt ist.
  • Wenn Sie eine neue oder geänderte Datei öffnen, werden die Zeilennummern innerhalb der Datei grün hervorgehoben, um neue oder geänderte Zeilen anzuzeigen. Entfernte Zeilen werden durch eine horizontale rote Linie gekennzeichnet.

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. Soforthilfe, Metadaten und Projektzustand)
  • Im Zeilenumbruchmodus des Editors

Wenn Sie die IDE auf die Standardeinstellungen zurücksetzen möchten, wählen Sie in der Looker IDE im linken Navigationsbereich das Symbol Settings (Einstellungen) aus, wählen Sie im Bereich IDE Settings (IDE-Einstellungen) den Tab Editor aus und klicken Sie dann auf die Schaltfläche Reset IDE Layout (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 wechseln direkt zu LookML-Objekten und ‐Projektdateien wechseln. 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

Klicken Sie auf das Symbol Soforthilfe, um den Bereich Soforthilfe zu öffnen. Dort finden Sie Erläuterungen und Optionen zur aktuellen Position im Code. 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 zum Schreiben von LookML-Code mit Gemini in Looker.

Optionsmenüs für Dateien und Ordner

Im Dateibrowser enthält jede Datei oder jeder Ordner in der linken Seitenleiste 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 auf das Menü zugreifen, indem Sie im Dateibrowser seitwärts scrollen.

Über die Optionsmenüs können Sie mit dem Dateibrowser Ordner und Dateien erstellen, Dateien hochladen sowie Dateien und Ordner löschen und verschieben. Weitere Informationen finden Sie auf der Dokumentationsseite 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. Dies entspricht den Änderungen, die Sie an Ihrem LookML-Projekt vornehmen.

Text im 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 Entwicklermodus befinden, sehen Sie außerdem das Feld Ersetzen durch. 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ählen Sie Auswählen und Ersetzen, um eine Vorschau davon zu sehen, wie der Text in Ihrem Projekt ersetzt werden würde.

  3. In den Ergebnissen werden alle Instanzen in Ihrem Projekt zum Ersetzen hervorgehoben. 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.
    • Verwenden Sie das Kästchen neben einer einzelnen Instanz, um diese Instanz auszuwählen oder die Auswahl aufzuheben.

  4. Wählen Sie die Schaltfläche Ausgewählte ersetzen aus, um die Ersetzung auf die ausgewählten Instanzen anzuwenden. Die IDE zeigt die vorgenommenen Änderungen an.

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

Zuerst fügen wir der Datenansicht users eine neue Dimension hinzu, mit der ermittelt wird, ob ein Nutzer aus Kalifornien oder aus New York kommt. 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.

Der LookML-Code 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 zur Ansichtsdatei user hinzu und klicken Sie 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 aggregiert.

Der LookML-Code für diesen neuen Measure sieht so aus:

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

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

Felder im Explore testen

Sie können die neue Dimension testen und analysieren, indem Sie sie abfragen. Nachdem Sie die Änderungen gespeichert haben, werden diese Felder im Field Picker in der explorativen Datenanalyse angezeigt. Verwenden Sie das Drop-down-Menü Dateiaktionen ansehen neben dem Dateinamen der Ansicht, um auf das Explore für die aktuelle Ansicht zuzugreifen. Im Drop-down-Menü Dateiaktionen ansehen werden alle Explores aufgelistet, die auf der Ansicht basieren, einschließlich Explores, mit denen die Ansicht verknüpft ist. Wenn Sie beispielsweise auf das Explore für eine Ansicht namens users zugreifen möchten, können Sie im Drop-down-Menü Dateiaktionen ansehen die Option Nutzer ansehen 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“.