Continuous Integration Content Validator

Mit der Inhaltsvalidierung für Continuous Integration (CI) werden Dashboards und Looks mit Fehlern identifiziert. Häufig werden diese Fehler durch fehlende Verweise auf LookML-Felder verursacht.

Der CI Content Validator führt eine ähnliche Validierung wie der Standard-Looker Content Validator durch, 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 eine Pull-Anfrage an Ihr LookML-Repository sendet, oder manuell, wenn Sie eine CI-Suite manuell ausführen.
    • Sie können die Ergebnisse der CI Content Validator auf bestimmte Looker-Inhaltsordner oder auf bestimmte Modelle und Explores in Ihrem LookML-Projekt beschränken. Standardmäßig sind die Ergebnisse des CI Content Validator automatisch auf Ihr LookML-Projekt beschränkt. Der CI Content Validator wird nach der Verarbeitung ausgeführt: Der Validator wird für die gesamte Looker-Instanz ausgeführt und filtert die Ergebnisse dann nach dem Bereich, den Sie beim Erstellen der CI-Suite angegeben haben.

  • Der Standard-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 Bereichseingrenzung der Looker Content Validator-Funktion erfolgt vor der Validierung. Der Validator wird nur für die Ordner und Projekte ausgeführt, die Sie beim Start 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 Content Validator 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 Continuous Integration-Suites ausführen.

Auf der Seite mit den Ausführungsergebnissen stellt Content Validator die Fehlermeldung für jeden Look oder jedes Dashboard mit Fehlern sowie einen Link zum Inhalt bereit:

Seite mit Ergebnissen der kontinuierlichen Integration mit Ergebnissen des Content Validators

Optionen für die Inhaltsvalidierung

Sie können beim Erstellen einer Suite für die kontinuierliche Integration mehrere Optionen angeben, um zu konfigurieren, wie der Content Validator ausgeführt wird. Die Optionen werden in den folgenden Abschnitten dieser Seite beschrieben:

Abzufragende Explores

Standardmäßig führt die Inhaltsvalidierung eine Inhaltsvalidierung für alle Modelle und Explores in Ihrem LookML-Projekt durch.

Mit dem Feld Explores to query (Abzufragende Explores) können Sie die Explores und Modelle angeben, die in die Inhaltsvalidierung einbezogen werden sollen.

Sie können Explores im folgenden Format angeben: model_name/explore_name

Wenn Sie beispielsweise die Explores mit den Namen 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 Angeben von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.

Auszuschließende Explores

Standardmäßig wird die Inhaltsvalidierung für alle Modelle und Explores in Ihrem LookML-Projekt ausgeführt.

Mit dem Feld Auszuschließende Explores können Sie die Explores und Modelle angeben, die von der Inhaltsvalidierung ausgeschlossen werden sollen.

Sie können Explores im folgenden Format angeben: model_name/explore_name

Weitere Informationen und Beispiele zum Angeben von Explores und Modellen in diesem Feld finden Sie auf der Dokumentationsseite SQL-Validator.

Zu validierende Ordner

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 Hauptnavigationsmenü von Looker 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 persönlichen Ordnern ausschließen

Wenn Sie möchten, dass die Inhaltsvalidierung nur Inhalte in freigegebenen Ordnern validiert, aktivieren Sie das Feld Inhalte in persönlichen Ordnern ausschließen. Wenn das Feld Inhalte in persönlichen Ordnern ausschließen aktiviert ist, werden Inhalte in den persönlichen Ordnern Ihrer Looker-Instanz von der Inhaltsvalidierung ignoriert.

Inkrementelle Validierung

Bei der inkrementellen Validierung werden Fehler identifiziert, die nur in einem bestimmten Entwicklungszweig vorhanden sind und noch nicht in die Produktionsumgebung übernommen wurden. Die inkrementelle Validierung hilft Entwicklern, die Fehler zu finden und zu beheben, für die sie verantwortlich sind, ohne durch vorhandene Fehler im Projekt abgelenkt zu werden. Außerdem kann die Validierung dadurch beschleunigt werden, insbesondere bei LookML-Projekten mit vielen Explores.

In den Validator-Ergebnissen gibt der Content Validator an, welche Explores übersprungen wurden, weil sich der kompilierte SQL-Code im zu validierenden Branch oder Commit nicht geändert hat. Ein Beispiel für 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 Abschnitt Content Validator das Kästchen Nur inkrementelle Fehler anklicken.

Beachten Sie bei der inkrementellen Validierung Folgendes:

  • Die Einstellung für die inkrementelle Validierung gilt nicht, wenn die Inhaltsvalidierung den Produktionszweig selbst validiert, etwa bei manuellen Ausführungen im Produktionszweig. Beim Validieren des Produktionszweigs zeigt die Inhaltsvalidierung die vollständigen Ergebnisse der Validierung an.

Einschränkungen der Inhaltsvalidierung

Wenn Sie ein Modell löschen oder seinen Namen ändern, gibt die Inhaltsvalidierung diese „verwaisten“ Inhaltsfehler nicht zurück, da das Modell nicht mehr dem getesteten Projekt zugeordnet werden kann.