LookML validieren

Wenn Sie Ihre LookML bearbeiten, werden Sie in der Looker IDE auf alle nicht behobenen Syntaxfehler in einer einzelnen Datei hingewiesen (siehe die Dokumentationsseite Looker IDE – Übersicht).

Verwenden Sie den LookML Validator, um eine vollständige Modellvalidierung durchzuführen. Einige Fehler, z. B. eine ungültige Feldreferenz aufgrund eines fehlenden Joins, erfordern einen ganzheitlichen Blick auf das Modell und werden daher nur angezeigt, wenn der LookML-Validator ausgeführt wird. Validieren Sie Ihre LookML-Änderungen, bevor Sie sie in der Produktionsumgebung veröffentlichen. Die Validierung kann zwar nicht alle Probleme erkennen, z. B. Probleme mit Datenbankberechtigungen, aber sie verhindert die meisten Fehler.

Der LookML Validator scannt nur LookML-Dateien, die seit der letzten LookML-Validierung aktualisiert wurden, oder Dateien, die von Aktualisierungen betroffen sind:

  • Wenn sich eine Einstellung auf Modellebene ändert, wird alles noch einmal überprüft.
  • Wenn sich eine Ansicht ändert, werden nur die Explores, in denen sie verwendet wird, noch einmal validiert.
  • Wenn sich ein Explore ändert, wird nur dieses Explore noch einmal validiert.

Validierung ausführen

Wenn Sie den LookML-Validator ausführen möchten, klicken Sie oben rechts in der Looker IDE auf die Schaltfläche LookML prüfen. Sie können auch oben in der IDE auf das Symbol Projektstatus klicken, um den Bereich Projektstatus zu öffnen, und dann auf das Symbol LookML prüfen.

Nachdem Sie den LookML Validator ausgeführt haben, wird möglicherweise eine Liste mit Fehlern und anderen Warnungen angezeigt, die Sie beheben sollten. Sie können einen beliebigen Pfeil auswählen, um die Liste der Fehler oder Warnungen zu maximieren.

Die Schaltfläche zum Validieren im Bereich Projektzustand wird wieder verfügbar, wenn Sie eine weitere Änderung vornehmen und speichern.

Validierungsnachrichten

Nachdem die Validierung für Ihren LookML-Code ausgeführt wurde, zeigt Looker Validierungsmeldungen an.

Keine LookML-Fehler gefunden

Wenn vom Validator keine Probleme gefunden wurden, zeigt Looker ein grünes Häkchen zusammen mit dem Text Keine LookML-Fehler gefunden an.

LookML-Fehler

LookML-Fehler sind Probleme, die die Ausführung von Abfragen verhindern können. Die Zahl in Klammern gibt die Anzahl der gefundenen Fehler an (im folgenden Beispiel neun):

Beispiel einer Validierungsnachricht mit dem Text LookML-Fehler (9).

In der erweiterten Liste der Probleme sehen Sie den Grund, warum die Überprüfung fehlgeschlagen ist. Wenn Sie auf den Fehler klicken, werden Sie oft direkt zur entsprechenden Codezeile weitergeleitet. Sie sehen ein rotes "X" neben der Zeile. Wenn Sie den Mauszeiger darauf bewegen, werden in einigen Fällen detailliertere Fehlerinformationen angezeigt:

Beispiel für einen Fehler, der angezeigt wird, wenn der Mauszeiger auf eine Typparameterdefinition ohne Wert bewegt wird, mit dem Fehlertext, dass Sie einen Wert für den Typ angeben müssen.

Tipp vom Chat-Team: Der Validierungsfehler, auf den wir am häufigsten gestellt werden, ist „Unbekanntes oder unzugängliches Feld“. Auf der Seite mit den Best Practices Fehler: Unbekannt oder nicht zugänglich finden Sie Informationen zu den Ursachen und möglichen Lösungen.

LookML-Warnungen

LookML-Warnungen verhindern möglicherweise nicht die Ausführung einer Abfrage, können aber dennoch zu fehlerhaften oder unbeabsichtigten Funktionen für Ihre Benutzer führen. Wie bei Fehlern gibt die Zahl in Klammern die Anzahl der gefundenen Warnungen an (im folgenden Beispiel drei Warnungen):

Beispiel für eine Validierungsnachricht mit dem Text LookML-Warnungen (3).

Wie bei LookML-Fehlern können Sie Warnungen maximieren und zum Problemcode springen, indem Sie die Warnung im Bereich Project Health (Projektzustand) auswählen und dann den Mauszeiger auf das rote X-Symbol bewegen, um weitere Informationen zu sehen:

Beispiel für eine Warnung mit einem Text, der besagt, dass das Explore mit einem Ansichtsnamen übereinstimmen muss oder dass das Explore eine Eigenschaft „from“ oder „view_name“ haben muss.

Änderungen bereitstellen

Nachdem Sie sich vergewissert haben, dass Ihre Änderungen ordnungsgemäß funktionieren, können Sie die Git-Integration von Looker verwenden, um Ihre Änderungen per Commit zu bestätigen und in der Produktion bereitzustellen.