Continuous Integration Content Validator

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

Die CI-Inhaltsvalidierung führt eine ähnliche Validierung wie die Standard-Inhaltsvalidierung von Looker durch, mit einigen Unterschieden:

  • Der CI Inhaltsvalidierung unterstützt Folgendes:

    • Sie können die CI-Inhaltsvalidierung so konfigurieren, dass sie entweder automatisch ausgeführt wird, wenn ein Looker-Entwickler eine Pull-Anfrage für Ihr LookML-Repository einreicht, oder manuell, wenn Sie eine CI-Suite manuell ausführen.
    • Sie können die Ergebnisse der CI-Inhaltsvalidierung auf bestimmte Looker-Inhaltsordner oder auf bestimmte Modelle und Explores in Ihrem LookML-Projekt beschränken. Standardmäßig sind die Ergebnisse der Looker-Inhaltsvalidierung automatisch auf Ihr LookML-Projekt beschränkt. Der CI Content Validator wird nach der Verarbeitung ausgeführt: Die Inhaltsvalidierung 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 Inhaltsvalidierung unterstützt Folgendes:

    • Sie können die Looker Inhaltsvalidierung nur manuell ausführen.
    • Sie können die Inhaltsvalidierung von Looker auf bestimmte Looker-Inhaltsordner oder auf bestimmte LookML-Projekte beschränken. Die Bereichseingrenzung der Looker-Inhaltsvalidierung erfolgt vor der Validierung. Die Validierung wird nur für die Ordner und Projekte ausgeführt, die Sie beim Start der Inhaltsvalidierung angegeben haben.
    • Mit der Looker Inhaltsvalidierung können Sie Namen für Felder, Ansichten, Explores und Modelle ersetzen, Felder entfernen und Looks löschen.

Details zu den Optionen, die Sie beim Erstellen oder Bearbeiten einer CI-Suite konfigurieren können, finden Sie im Abschnitt Optionen für Inhaltsvalidierung auf dieser Seite. Informationen zum Ausführen der Inhaltsvalidierung finden Sie auf der Dokumentationsseite Continuous Integration-Suites ausführen.

Auf der Seite mit den Ausführungsergebnissen wird von der Inhaltsvalidierung für jeden Look oder jedes Dashboard mit Fehlern die Fehlermeldung zusammen mit einem Link zum Inhalt angezeigt:

Seite mit Ergebnissen der kontinuierlichen Integration mit Ergebnissen der Inhaltsvalidierung

Optionen für die Inhaltsvalidierung

Sie können beim Erstellen einer Suite für Continuous Integration mehrere Optionen angeben, um zu konfigurieren, wie die Inhaltsvalidierung 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 aus.

Mit dem Feld Explores to query (Abzufragende Explores) können Sie das Explore und die 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 führt die Inhaltsvalidierung eine Inhaltsvalidierung für alle Modelle und Explores in Ihrem LookML-Projekt aus.

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, verwenden Sie das Looker-Hauptnavigationsmenü, um den Ordner zu öffnen, 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 Validierungsergebnissen gibt die Inhaltsvalidierung jedes Explore an, das übersprungen wurde, weil sich das kompilierte SQL im Branch oder Commit, der validiert wurde, 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 die Inhaltsvalidierung aktivieren, indem Sie beim Erstellen oder Bearbeiten einer Continuous Integration-Suite im Abschnitt Inhaltsvalidierung 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 Projekt zugeordnet werden kann, das getestet wird.