Der CI-Inhaltsvalidierer (Continuous Integration) erkennt Dashboards und Looks mit Fehlern. Häufig sind fehlende Verweise auf LookML-Felder die Ursache.
Der CI Content Validator führt eine ähnliche Validierung durch wie der Looker Content Validator, mit einigen Unterschieden:
Der CI Content Validator unterstützt Folgendes:
- Sie können den CI Content Validator so konfigurieren, dass er entweder automatisch ausgeführt wird, wenn ein Looker-Entwickler einen Pull-Request an Ihr LookML-Repository sendet, oder manuell, wenn Sie eine CI-Suite manuell ausführen.
- Sie können die Ergebnisse der Inhaltsvalidierung auf bestimmte Looker-Inhaltsordner oder auf bestimmte Modelle und Explores in Ihrem LookML-Projekt beschränken. Standardmäßig werden die Ergebnisse des CI Content Validators automatisch auf Ihr LookML-Projekt angewendet. Die Begrenzung des CI Content Validators erfolgt nach der Verarbeitung: Der Validator wird auf der gesamten Looker-Instanz ausgeführt und filtert die Ergebnisse dann auf die Begrenzung, die Sie beim Erstellen der CI-Suite angegeben haben.
Der standardmäßige Looker Content Validator unterstützt Folgendes:
- Sie können den Looker Content Validator nur manuell ausführen.
- Sie können den Looker Content Validator auf bestimmte Looker-Inhaltsordner oder auf bestimmte LookML-Projekte beschränken. Die Begrenzung des Looker Content Validator erfolgt vor der Validierung: Der Validator wird nur auf den Ordnern und Projekten ausgeführt, die Sie beim Starten der Inhaltsvalidierung angegeben haben.
- Mit dem Looker Content Validator können Sie Namen für Felder, Ansichten, Explores und Modelle ersetzen, Felder entfernen und Looks löschen.
Im Abschnitt Optionen für den Inhaltsvalidierer auf dieser Seite finden Sie Details zu den Optionen, die Sie beim Erstellen oder Bearbeiten einer CI-Suite konfigurieren können. Informationen zum Ausführen des Content Validators finden Sie auf der Dokumentationsseite Suites für die kontinuierliche Integration ausführen.
Auf der Seite mit den Ausführungsergebnissen gibt der Inhaltsvalidierer für jeden Look oder jedes Dashboard mit Fehlern eine Fehlermeldung sowie einen Link zum Inhalt an:
Optionen für die Inhaltsvalidierung
Beim Erstellen einer Continuous-Integration-Suite können Sie mehrere Optionen angeben, um die Ausführung des Content Validators zu konfigurieren. Die Optionen werden in den folgenden Abschnitten dieser Seite beschrieben:
- Explores, die abgefragt werden sollen
- Auszuschließende Explores
- Ordner, die validiert werden sollen
- Auszuschließende Ordner
- Inhalte in privaten Bereichen ausschließen
- Inkrementelle Validierung
Explores, die abgefragt werden sollen
Standardmäßig führt der Inhaltsvalidierer die Inhaltsvalidierung für alle Modelle und Explores in Ihrem LookML-Projekt aus.
Im Feld Explores to query (Explores für Abfrage) können Sie das Explore und die Modelle angeben, die in die Inhaltsüberprüfung einbezogen werden sollen.
Sie können explorative Datenanalysen im folgenden Format angeben: model_name/explore_name
Wenn Sie beispielsweise die Explores users und orders in der Datei thelook.model.lkml angeben möchten, geben Sie Folgendes ein: thelook/users, thelook/orders
Weitere Informationen und Beispiele zum Festlegen von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.
Auszuschließende Explores
Standardmäßig führt der Inhaltsvalidierer die Inhaltsvalidierung für alle Modelle und Explores in Ihrem LookML-Projekt aus.
Im Feld Auszuschließende Explores können Sie die Explores und Modelle angeben, die von der Inhaltsüberprüfung ausgeschlossen werden sollen.
Sie können explorative Datenanalysen im folgenden Format angeben: model_name/explore_name
Weitere Informationen und Beispiele zum Festlegen von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.
Ordner, die validiert werden sollen
Sie können die Inhaltsvalidierung auf bestimmte Inhaltsordner in Ihrer Looker-Instanz beschränken, indem Sie eine Ordner-ID oder eine durch Kommas getrennte Liste von Ordner-IDs angeben.
Wenn Sie die ID eines Ordners abrufen möchten, öffnen Sie den Ordner über das Looker-Hauptnavigationsmenü und rufen Sie dann die Ordner-ID aus der Browser-URL ab. Die Ordner-ID ist das letzte Element der URL. In der folgenden URL lautet die Ordner-ID beispielsweise 45:
https://myinstance.looker.com/folders/45
Auszuschließende Ordner
Sie können bestimmte Inhaltsordner von der Inhaltsvalidierung ausschließen, indem Sie im Feld Auszuschließende Ordner eine Ordner-ID oder eine durch Kommas getrennte Liste von Ordner-IDs angeben.
Inhalte in privaten Bereichen ausschließen
Wenn der Content Validator nur Inhalte in freigegebenen Ordnern prüfen soll, aktivieren Sie das Feld Inhalte in privaten Bereichen ausschließen. Wenn das Feld Inhalte in privaten Bereichen ausschließen aktiviert ist, werden Inhalte in den privaten Ordnern Ihrer Looker-Instanz vom Content Validator ignoriert.
Inkrementelle Validierung
Die inkrementelle Validierung ist eine Methode, um Fehler zu finden, die nur für einen bestimmten Entwicklungszweig spezifisch sind, also Fehler, die in der Produktion noch nicht vorhanden sind. Mit der inkrementellen Validierung können Entwickler die Fehler, für die sie verantwortlich sind, finden und beheben, ohne von vorhandenen Fehlern im Projekt abgelenkt zu werden. Außerdem kann die Validierung so schneller erfolgen, insbesondere bei LookML-Projekten mit vielen Explores.
In den Ergebnissen des Validators gibt der Inhaltsvalidator jedes Explore an, das übersprungen wurde, weil es im zu validierenden Branch oder Commit keine Änderungen am kompilierten SQL gab. Ein Beispiel für die Ergebnisse der inkrementellen Validierung finden Sie unter Ergebnisse der inkrementellen Validierung ansehen.
Sie können die inkrementelle Validierung für den Content Validator aktivieren, indem Sie beim Erstellen oder Bearbeiten einer Continuous-Integration-Suite im Bereich Content Validator das Kästchen Nur inkrementelle Fehler anklicken.
Beachten Sie für die inkrementelle Validierung Folgendes:
- Die Einstellung für die inkrementelle Validierung gilt nicht, wenn der Content Validator den Produktionszweig selbst validiert, z. B. bei manuellen Ausführungen im Produktionszweig. Bei der Validierung des Produktionszweigs zeigt der Content Validator die vollständige Validierung der Ergebnisse an.
Einschränkungen der Inhaltsvalidierung
Wenn Sie ein Modell löschen oder seinen Namen ändern, gibt der Inhaltsvalidierer diese „in der Schwebe befindlichen“ Inhaltsfehler nicht zurück, da das Modell nicht mehr mit dem getesteten Projekt verknüpft werden kann.