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 die meisten Fehler werden dadurch verhindert.

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 geprüft.
  • 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.

Nach dem Ausführen des LookML-Validators 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 Listen mit Fehlern oder Warnungen zu maximieren.

Die Schaltfläche für den Validator im Bereich Projektstatus wird wieder verfügbar, wenn Sie eine weitere Änderung vornehmen und speichern.

Validierungsnachrichten

In Looker werden Validierungsmeldungen angezeigt, nachdem die Validierung Ihrer LookML abgeschlossen wurde.

Keine LookML-Fehler gefunden

Wenn der Validator keine Probleme findet, wird in Looker ein grünes Häkchen mit der Meldung Keine LookML-Fehler gefunden angezeigt.

LookML-Fehler

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

Beispiel für eine Validierungsmeldung mit dem Text „LookML-Fehler (9)“

In der erweiterten Liste der Probleme sehen Sie den Grund, warum die Validierung nicht bestanden wurde. Wenn Sie auf den Fehler klicken, werden Sie oft direkt zur entsprechenden Codezeile weitergeleitet. Neben der Zeile wird ein rotes „X“ angezeigt. Wenn Sie den Mauszeiger darauf bewegen, werden in einigen Fällen detailliertere Fehlerinformationen angezeigt:

Beispiel für einen Fehler, der beim Bewegen des Mauszeigers auf eine Typparameterdefinition ohne Wert angezeigt wird. Der Fehlertext weist darauf hin, dass Sie einen Wert für den Typ angeben müssen.

Tipp vom Chatteam: Der Validierungsfehler, für den wir am häufigsten um Unterstützung gebeten werden, ist „Unknown or inaccessible field“ (Unbekanntes oder unzugängliches Feld). Auf der Seite mit Best Practices für den Fehler Fehler: Unbekanntes oder unzugängliches Feld finden Sie Informationen zu den Ursachen und zu den möglichen Maßnahmen.

LookML-Warnungen

LookML-Warnungen verhindern möglicherweise nicht, dass eine Abfrage ausgeführt wird, können aber dennoch zu nicht funktionierenden oder nicht beabsichtigten Funktionen für Ihre Nutzer 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 Validierungsmeldung mit dem Text „LookML-Warnungen (3)“.

Wie bei LookML-Fehlern können Sie Warnungen maximieren und zum Code des Problems springen, indem Sie die Warnung im Bereich Projektstatus auswählen und den Mauszeiger auf das rote X-Symbol bewegen, um weitere Informationen zu sehen:

Beispiel für eine Warnung, in der steht, dass der Name des Explores mit dem Namen einer Datenansicht übereinstimmen muss oder dass das Explore die Property „from“ oder „view_name“ haben muss.

Änderungen bereitstellen

Nachdem Sie überprüft haben, ob Ihre Änderungen ordnungsgemäß funktionieren, können Sie die Git-Integration von Looker verwenden, um Ihre Änderungen zu committen und in der Produktionsumgebung bereitzustellen.