Bei LookML-Projekten, in denen alle Entwickler in der Looker-IDE arbeiten, ist die LookML-Validierung in den Prozess der Bereitstellung des Projekts für die Produktion integriert. Bei LookML-Projekten, bei denen einige oder alle Entwickler außerhalb der Looker-IDE arbeiten und eine externe IDE wie VSCode oder Vim zum Schreiben von LookML verwenden, ist es jedoch möglich, das Projekt in der Produktion bereitzustellen, ohne die LookML-Syntax zu validieren. In diesem Fall können Sie den LookML-Validator für Continuous Integration (CI) ausführen, um Syntaxprobleme in Ihrem LookML-Code zu finden, z. B. ein fehlendes }
oder einen ungültigen ${}
-Verweis.
Weitere Informationen zu den Optionen, die Sie beim Erstellen oder Bearbeiten einer CI-Suite konfigurieren können, finden Sie im Abschnitt LookML-Validator-Optionen auf dieser Seite. Informationen zum Ausführen des LookML-Validators finden Sie auf der Dokumentationsseite Continuous Integration-Suites ausführen.
Auf der Seite mit den Ausführungsergebnissen werden die LookML-Fehler in Ihrem Projekt zusammen mit einem Link zur LookML angezeigt:
Optionen für den LookML Validator
In den folgenden Abschnitten werden die Optionen zum Ausführen des LookML-Validators beschrieben:
Schweregradschwellenwert festlegen
Die Einstellung für die Wichtigkeitsstufe bestimmt die niedrigste Wichtigkeitsstufe einer LookML-Meldung, die dazu führt, dass für den CI-Lauf auf der Seite CI-Läufe und auf der Ergebnisseite des CI-Laufs der CI-Status Fehlgeschlagen angezeigt wird.
In der Looker-IDE gibt die LookML-Validierung Syntaxmeldungen mit drei Schweregraden zurück: „Information“, Warnung und Fehler.
Standardmäßig führt der LookML-Validator nur dann zu einem CI-Status Fehler, wenn er LookML-Warnungen oder -Fehler im LookML-Projekt findet. Sie können den niedrigsten Schweregrad für Nachrichten auswählen, für den der CI LookML Validator das Ergebnis Fehler zurückgeben soll:
- Fehler: Der CI LookML Validator gibt das Ergebnis Failed (Fehler) zurück, wenn bei der LookML-Validierung eine Fehlermeldung zurückgegeben wird.
- Warnung: Der CI LookML Validator gibt das Ergebnis Failed zurück, wenn bei der LookML-Validierung eine Warnung oder Fehlermeldung zurückgegeben wird.
- Hinweis: Der CI LookML Validator gibt das Ergebnis Failed zurück, wenn die LookML-Validierung eine Info-, Warn- oder Fehlermeldung zurückgibt.
Dieser Schweregradschwellenwert wirkt sich nur auf den Statuswert des CI-Laufs aus. Unabhängig von der Einstellung des Schweregrads werden in den Ergebnissen des LookML-Validators alle Syntaxprobleme und alle LookML-Syntaxmeldungen auf der Ergebnisseite des CI-Laufs angezeigt.
Zeitlimit
Sie können die Anzahl der Sekunden angeben, die der CI LookML Validator ausgeführt werden soll, bevor ein Timeout eintritt. Der Standardwert ist 600 Sekunden. Wenn der CI LookML Validator länger als das Zeitlimit benötigt, wird der Job abgebrochen und der Laufstatus Error zurückgegeben.