Inhaltsvalidierung

Der Inhaltsvalidator sucht in Ihrer LookML nach den Modell-, Explore- und Feldnamen, auf die in Ihren Looker-Inhalten (Looks und Dashboards) verwiesen wird. Es ist ein nützliches Tool, um LookML-Referenzen zu validieren, Fehler in Ihrer LookML nach Änderungen zu beheben und die Namen von LookML-Elementen in Ihrem gesamten Projekt zu aktualisieren.

Sie benötigen die Berechtigung develop, um den Inhaltsprüfer verwenden zu können.

Der Grund dafür ist, dass Entwickler Inhalte korrigieren müssen, die möglicherweise beschädigt werden, wenn sie Änderungen an der zugrunde liegenden LookML vornehmen.

Um den Content Validator zu öffnen, wählen Sie im Hauptnavigationsbereich im Menü Entwickeln die Option Content Validator aus. Sie haben zwei Möglichkeiten, den Inhaltsvalidierer zu verwenden:

Vor der Verwendung des Inhaltsvalidators

Sie müssen äußerst vorsichtig sein, wenn Sie Änderungen mithilfe der Inhaltsüberprüfung vornehmen. Der Inhaltsvalidierer hat keine Undo-Funktion und kann sich auf viele Looks und Dashboards sowie deren Explore from Here-Links auswirken. Wenn Sie einen Fehler machen, sollten Sie ihn so schnell wie möglich korrigieren, bevor weitere Änderungen es erschweren, die betroffenen Looks zu isolieren.

Berücksichtigen Sie auch den richtigen Zeitpunkt, um den Inhaltsvalidierer zu verwenden. Wenn Sie Entwicklungsänderungen in die Produktion pushen, sollten Sie die betroffenen Looks und Ansichten ungefähr gleichzeitig korrigieren, damit sie nur so kurz wie möglich nicht funktionieren. Wenn Sie Looks und Kacheln zu früh korrigieren, basierend auf Ihrer Arbeit im Entwicklungsmodus, werden sie Nutzern als fehlerhaft angezeigt, bis Sie Ihre Änderungen veröffentlichen. Wenn Sie die Korrektur von Looks und Kacheln erst lange nach dem Pushen der Änderungen vornehmen, werden sie Nutzern als fehlerhaft angezeigt, bis Sie sie korrigiert haben.

Fehler mit dem Content Validator beheben

Der Inhaltsvalidierer ist ein nützliches Tool, um Fehler zu finden und zu beheben, die durch Änderungen an Ihrer LookML-Datei verursacht wurden. Wenn Sie beispielsweise den Namen eines Felds von customer in user ändern, funktionieren alle Looks oder Dashboard-Kacheln, die das Feld customer enthalten, nicht mehr, es sei denn, Sie haben den Parameter alias verwendet. Der Inhaltsvalidierer listet alle Verweise auf das Feld customer auf und bietet die Schaltflächen Ersetzen oder Entfernen, um den Fehler zu beheben.

Wenn Sie den Inhaltsvalidierer ausführen, werden alle Verweise validiert, die Ihre Looks und Dashboards auf Ihre LookML-Modelle, Explores, Ansichten und Felder enthalten. Für alle Verweise auf ein unbekanntes LookML-Objekt wird ein Fehler angezeigt.

Der Inhaltsvalidierer zeigt keine Fehler für Folgendes an:

  • Looks, die gelöscht wurden und sich im Papierkorb befinden. Wenn Sie einen gelöschten Look prüfen möchten, muss Ihr Looker-Administrator ihn zuerst wiederherstellen.

  • Inhalte, die auf LookML-Modellen basieren, für die Sie keine develop-Berechtigung haben Sie können den Inhaltsvalidierer nur auf Inhalte anwenden, die auf Modellen basieren, für die Sie die Berechtigung develop haben (die Modelle, die Sie in der Looker IDE sehen). Informationen zu Berechtigungen für Modelle finden Sie auf der Dokumentationsseite Rollen.

Inhaltsvalidierung ausführen

Um die Leistung des Content Validators zu verbessern, kann ein Looker-Administrator die Labs-Funktion Content Validator Scoping in Ihrer Instanz aktivieren. Wenn diese Labs-Funktion aktiviert ist, können Sie die Validierung auf bestimmte LookML-Projekte und einen bestimmten Inhaltsordner beschränken. Im Abschnitt Umfang der Inhaltsüberprüfung festlegen finden Sie Informationen dazu, wie Sie den Umfang der Überprüfung festlegen.

Wenn die Funktion „Content Validator Scoping Labs“ in Ihrer Instanz nicht aktiviert ist, führen Sie die folgenden Schritte aus, um die Inhaltsüberprüfung auszuführen:

  1. Klicken Sie auf das Looker-Hauptmenü  und wählen Sie Entwickeln aus, falls das Menü Entwickeln nicht bereits angezeigt wird.
  2. Wähle im Menü Entwickeln die Option Inhaltsvalidierer aus.
  3. Klicken Sie auf der Seite „Content Validator“ (Inhaltsvalidierer) auf Validate (Validieren).

Der Content Validator führt eine Validierung aller Inhalte durch, die auf LookML-Projekten basieren, für die Sie die Berechtigung develop haben, und zeigt dann die Ergebnisse an. Informationen zum Prüfen der Ergebnisse finden Sie im Abschnitt Ergebnisse der Inhaltsvalidierung ansehen.

Umfang der Inhaltsvalidierung

Wenn die Labs-Funktion Content Validator Scoping aktiviert ist, können Sie die Validierung auf bestimmte LookML-Projekte und einen bestimmten Inhaltsordner (einschließlich aller Unterordner) beschränken. Dadurch kann die Leistung des Content Validators verbessert werden.

Beachten Sie Folgendes:

  • Wenn Sie keinen Ordner oder kein LookML-Projekt angeben, wird die Validierung nicht eingegrenzt. Der Content Validator validiert alle Inhalte, die auf Modellen basieren, für die Sie die Berechtigung develop haben.
  • Wenn Sie einen Inhaltsordner angeben, führt der Content Validator eine Validierung für den Inhaltsordner und alle darin enthaltenen Unterordner durch (falls vorhanden).
  • Wenn Sie einen Inhaltsordner und ein oder mehrere LookML-Projekte angeben, gelten beide Bedingungen: Die Inhaltsüberprüfung beschränkt sich auf die Inhalte im Ordner (und in den Unterordnern), die auf den von Ihnen ausgewählten LookML-Projekten basieren.
  • Dashboard-Benachrichtigungen, Dashboard-Zeitpläne und Look-Zeitpläne werden nicht in Inhaltsordnern gespeichert. Wenn Sie die Inhaltsvalidierung also auf einen Ordner beschränken, werden keine Zeitpläne oder Benachrichtigungen validiert.

  • Wenn Sie ein LookML-Projekt angeben, ermittelt der Inhaltsvalidierer die zugehörigen Modelle des Projekts anhand der Quell-LookML der angegebenen Projekte und der für jedes Projekt konfigurierten Modelle. Diese finden Sie auf der Seite LookML-Projekte. Wenn eine Modelldatei aus einem LookML-Projekt gelöscht wurde und auf der Seite LookML-Projekte nicht als Modell angezeigt wird, werden im Inhaltsvalidierer keine Fehler angezeigt, die sich auf Inhalte beziehen, die auf diesem gelöschten Modell basieren.

So führen Sie den Content Validator in einer Looker-Instanz aus, in der die Begrenzung des Content Validators aktiviert ist:

  1. Klicken Sie auf das Looker-Hauptmenü  und wählen Sie Entwickeln aus, falls das Menü Entwickeln nicht bereits angezeigt wird.
  2. Wähle im Menü Entwickeln die Option Inhaltsvalidierer aus.

  3. Klicken Sie auf der Seite „Content Validator“ (Inhaltsvalidierer) auf Validate (Validieren).

    Im Inhaltsvalidierer wird das Dialogfeld Zu validierende Projekte auswählen angezeigt.

  4. Führen Sie im Dialogfeld Zu validierende Projekte auswählen einen der folgenden Schritte aus:

    • Wenn Sie den Validator für alle LookML-Projekte ausführen möchten, lassen Sie das Feld Projekte auswählen leer und klicken Sie auf Weiter.
    • Wenn Sie den Validator für ein oder mehrere LookML-Projekte ausführen möchten, klicken Sie auf das Drop-down-Menü Projekte auswählen, wählen Sie die Projekte aus, die Sie validieren möchten, und klicken Sie dann auf Weiter.

    Im Inhaltsvalidierer wird das Dialogfeld Ordner zum Validieren auswählen angezeigt.

  5. Führen Sie im Dialogfeld Ordner zum Validieren auswählen einen der folgenden Schritte aus:

    • Wenn Sie den Validator auf alle Inhaltsordner ausführen möchten, lassen Sie die Auswahl Ordner unverändert (d. h. ohne ausgewählte Ordner) und klicken Sie auf Weiter.
    • Wenn Sie den Validator auf einen bestimmten Inhaltsordner und gegebenenfalls seine Unterordner anwenden möchten, wählen Sie in der Auswahl Ordner den Ordner aus, den Sie validieren möchten, und klicken Sie dann auf Weiter.

    Im Dialogfeld Auswahl überprüfen werden die Projekte und Ordner angezeigt, die Sie zur Validierung ausgewählt haben.

  6. Klicken Sie im Dialogfeld Auswahl überprüfen auf Überprüfen.

Der Content Validator führt dann eine Validierung der von Ihnen angegebenen Inhalte durch und zeigt die Ergebnisse an. Informationen zum Prüfen der Ergebnisse finden Sie im Abschnitt Ergebnisse der Inhaltsvalidierung ansehen.

Ergebnisse der Inhaltsvalidierung ansehen

Wenn die Validierung mit dem Content Validator abgeschlossen ist, wird eine Fehlertabelle angezeigt. Wenn ein Looker-Administrator die Labs-Funktion Content Validator Scoping in Ihrer Instanz aktiviert hat, werden die Validierungsergebnisse auf die Projekte und Ordner beschränkt, die Sie beim Ausführen des Content Validators ausgewählt haben.

Die Ergebnisse der Inhaltsvalidierung zeigen Looker-Inhalte, in denen Modellnamen, Explore-Namen, Ansichtsnamen oder Feldnamen verwendet werden, die nicht vorhanden sind oder nicht gefunden werden können. Im Abschnitt Fehler mit dem Inhaltsvalidierer beheben finden Sie Details zu den LookML-Elementen, die der Inhaltsvalidierer finden und validieren kann.

Die Validierungsergebnisse basieren auf der LookML, die im Modus verfügbar ist, in dem Sie den Validator ausführen. Wenn Sie sich im Produktionsmodus befinden, spiegeln die Validierungsergebnisse die gesamte LookML wider, die in die Produktion verschoben wurde. Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihre gespeicherte LookML wider, auch wenn die LookML nicht in die Produktion verschoben wurde.

In der Fehlertabelle werden alle Fehler zusammen mit einer Liste der Looks und Kacheln angezeigt, in denen der Fehler auftritt, sowie das zugrunde liegende Modell und das Explore, das den Fehler verursacht.

Fenster des Content Validators mit mehreren Fehlern in den Validierungsergebnissen

Über die Tabs Nach oben rechts auf der Seite können Sie das Layout der Fehlertabelle ändern:

  • Fehler: Hier werden alle Fehler aufgelistet und die Looker-Inhalte mit dem Fehler gruppiert. Das ist nützlich, wenn Sie denselben Fehler in mehreren Inhalten gleichzeitig korrigieren möchten.
  • Ordner: Hier werden alle Ordner aufgelistet und die Looker-Inhalte mit Fehlern gruppiert. Das ist nützlich, wenn Sie nur die Fehler in einem bestimmten Ordner korrigieren möchten.
  • Inhalte: Listen Sie alle Inhalte auf, die Fehler enthalten, und gruppieren Sie die Fehler. Das ist nützlich, wenn Sie alle Fehler in einem einzelnen Look, einer einzelnen Kachel oder einem einzelnen Filter usw. beheben möchten.

Das Symbol neben dem Namen des Inhalts gibt den Inhaltstyp an:

  • Symbol für Kachel im Dashboard – Dashboardkachel
  • Benachrichtigungssymbol auf dem Dashboard – Dashboard-Benachrichtigung
  • Symbol „Planen“ auf dem Dashboard oder „Planen“ auf dem Look – Planung für ein Dashboard oder einen Look
  • Filtersymbol auf dem Dashboard: Filter für ein Dashboard oder ein Feld auf einer Kachel, das auf einen Dashboard-Filter reagiert. Weitere Informationen zum Konfigurieren von Kacheln für Dashboard-Filter finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

Fehler können durch beabsichtigte Änderungen in Ihrer LookML, einen Tippfehler oder einen fehlenden Join verursacht werden.

Je nach Fehlertyp wird in Looker für jede Zeile entweder die Schaltfläche Ersetzen oder Entfernen oder beide angezeigt. Mit diesen Schaltflächen können Sie die Fehler beheben. Weitere Informationen finden Sie unter Fehler mit dem Inhaltsvalidierer beheben. Sie können Fehler mit den Schaltflächen Ersetzen und Entfernen in jeder Zeile der Fehlertabelle korrigieren. Gehen Sie dazu so vor:

  • Ersetzen: In Looker wird für jeden Fehler die Schaltfläche Ersetzen angezeigt. Weitere Informationen zum Ersetzen von Namen mit dem Inhaltsvalidierer finden Sie weiter unten auf dieser Seite im Abschnitt Namen für Felder, Ansichten, Explores und Modelle ersetzen.
  • Entfernen: Bei Fehlern mit Feldnamen im Bereich Daten eines Looks oder einer Kachel wird in Looker auch die Schaltfläche Entfernen angezeigt. Weitere Informationen zum Entfernen von Namen mit dem Inhaltsvalidierer finden Sie weiter unten auf dieser Seite im Abschnitt Feldnamen entfernen.

Je nach Einstellung für Gruppieren nach werden die Schaltflächen Ersetzen und Entfernen auf ein einzelnes Element (Look oder Kachel) oder auf mehrere Elemente angewendet:

  • Wenn Sie nach Fehler gruppieren, gelten die Schaltflächen für alle Vorkommen dieses Fehlers in allen Looks und Kacheln Ihrer Looker-Instanz. So können Sie alle Vorkommen in einem einzigen Vorgang beheben.
  • Wenn Sie nach Ordner oder Inhalt gruppieren, beziehen sich die Schaltflächen auf ein einzelnes Vorkommen des Fehlers in einem einzelnen Look oder einer einzelnen Kachel. So können Sie jedes Vorkommen des Fehlers separat betrachten.

Eine Fehlertabelle ist beispielsweise nach Fehler gruppiert und enthält drei Inhaltsinstanzen mit einem unbekannten Explore namens customers. Für die drei Inhalte wurde die Aktion Ersetzen angegeben. Wenn Sie auf Ersetzen klicken, wirkt sich das auf alle drei Instanzen des Inhalts mit dem Fehler 3 x Unknown explore 'customers' aus.

In einigen Fällen können für Inhalte mehrere Fehler vorliegen. Eine Fehlertabelle ist beispielsweise nach Inhalt gruppiert und enthält den Inhalt Bestelldetails. In der Spalte Fehler sind vier Unknown field-Fehler zu sehen. Für jeden Fehler gibt es in der Spalte Aktionen die Aktionsschaltflächen Ersetzen und Entfernen.

Wenn Sie nach Inhalten gruppieren, haben Sie außerdem die Möglichkeit, Looks zu löschen.

Namen für Felder, Ansichten, Explores und Modelle ersetzen

Die Ergebnisse der Inhaltsüberprüfung enthalten für die folgenden Elementtypen die Schaltfläche Ersetzen, mit der Sie sie umbenennen können:

Bei jedem dieser Fehler können Sie mit dem Content Validator ein Attribut des Inhalts ersetzen, das mit dem fehlerhaften Attribut übereinstimmt oder allgemeiner ist:

  • Wenn ein Feld einen Fehler verursacht, können Sie es ersetzen oder entfernen. Sie können auch den Namen der Datenansicht, des Explores oder des Modells ersetzen.
  • Wenn ein Explore-Name zu einem Fehler führt, können Sie den Explore-Namen oder den Modellnamen ersetzen.
  • Wenn ein Modellname zu einem Fehler führt, können Sie ihn ersetzen.

So ersetzen Sie mit dem Inhaltsvalidierer die Namen von Elementen in Ihrem Modell:

  1. Klicken Sie auf Validieren, um den Inhaltsvalidierer auszuführen.
  2. Wählen Sie eine Einstellung für Gruppieren nach aus, um festzulegen, wie Fehler gruppiert werden. Sie können beispielsweise nach Fehler gruppieren, um mehrere Elemente gleichzeitig anzupassen.

  3. Klicken Sie in der Fehlertabelle neben dem Fehler, den Sie korrigieren möchten, auf die Schaltfläche Ersetzen, um das Dialogfeld Im Inhalt aktualisieren zu öffnen.

  4. Wählen Sie im Dialogfeld In Inhalten aktualisieren im Bereich Typ den Typ des LookML-Elements aus, das Sie ändern möchten: Feld, Ansicht, explorative Datenanalyse oder Modell. In Looker werden für jeden Fehler die entsprechenden Optionen angezeigt.

  5. Überprüfen Sie im Bereich Name den Namen des Elements, das Sie ersetzen möchten. Diese Informationen werden vom Content Validator automatisch eingefügt.

  6. Geben Sie im Bereich Ersatzname den neuen Namen des Artikels ein.

  7. Wenn Sie nach Fehler gruppiert haben und mehrere Elemente betroffen sind, können Sie auf Inhalte anzeigen klicken, um eine Liste der Elemente aufzurufen, die vom Inhaltsprüfer aktualisiert werden.

  8. Optional können Sie die Kästchen neben den aufgeführten Elementen deaktivieren, um ihre Namen unverändert zu lassen.

  9. Klicken Sie auf Ersetzen, um die Änderung vorzunehmen.

Feldnamen entfernen

Bei Fehlern mit Feldnamen im Bereich Daten eines Datasets oder einer Kachel wird in der Fehlertabelle rechts neben dem Fehler die Schaltfläche Entfernen angezeigt. Mit dem Inhaltsprüfer können Sie Felder entfernen, die

  • Im Bereich Daten einer Look- oder Dashboardkachel
  • Wird in Visualisierungskonfigurationen referenziert, z. B. im Bereich Anpassungen auf dem Tab Reihe für Säulendiagramme
  • Wird von einer Dashboardkachel referenziert, um auf einen Dashboard-Filter zu hören. Diese Konfiguration erfolgt im Fenster „Filterkonfiguration“ auf dem Tab Zu aktualisierende Kacheln. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

Mit dem Content Validator können Sie keine Felder aus benutzerdefinierten Filtern, benutzerdefinierten Feldern oder Tabellenberechnungen entfernen, da Sie in der Regel zusätzliche Änderungen vornehmen müssen, damit der Ausdruck weiterhin funktioniert. Verwenden Sie stattdessen die Fehlermeldungen zur Inhaltsvalidierung, um Stellen zu finden, an denen benutzerdefinierte Filter, benutzerdefinierte Felder und Ausdrucke für Tabellenberechnungen korrigiert werden müssen, und bearbeiten Sie den Ausdruck dann entsprechend.

  1. Klicken Sie auf Validieren, um den Inhaltsvalidierer auszuführen.
  2. Wählen Sie eine Einstellung für Gruppieren nach aus, um festzulegen, wie Fehler gruppiert werden. Sie können beispielsweise nach Fehler gruppieren, um mehrere Elemente (Looks, Ansichten oder beides) gleichzeitig anzupassen.

  3. Klicken Sie in der Fehlertabelle neben dem Feldfehler, den Sie korrigieren möchten, auf Entfernen, um das Dialogfeld Feld aus dem Inhalt entfernen zu öffnen.

  4. Überprüfen Sie im Bereich Feld des Dialogfelds Feld aus Inhalten entfernen den Namen des Elements, das Sie entfernen möchten. Dieser wird vom Content Validator automatisch ausgefüllt.

  5. Wenn Sie nach Fehler gruppiert haben und es mehrere Elemente gibt (Looks, Ansichten oder beides), können Sie auf Inhalte anzeigen klicken, um eine Liste der Elemente aufzurufen, die vom Content Validator aktualisiert werden.

  6. Optional können Sie die Kästchen neben den Looks oder Kacheln deaktivieren, um ihre Namen unverändert zu lassen.

  7. Klicken Sie auf Feld entfernen, um die Änderung vorzunehmen.

Looks löschen

Wenn Sie die Fehlertabelle nach Inhalt gruppieren, haben Sie die Möglichkeit, Looks in der Tabelle zu löschen.

So löschen Sie Looks mit dem Content Validator:

  1. Klicken Sie auf Validieren, um den Inhaltsvalidierer auszuführen.
  2. Gruppieren Sie die Tabelle nach Inhalt.
  3. Klicken Sie in der Fehlertabelle neben den Looks, die Sie löschen möchten, auf das Kästchen Auswählen.
  4. Klicken Sie oben in der Fehlertabelle auf die Schaltfläche Alle ausgewählten Looks löschen.
  5. Klicken Sie im Bestätigungsfeld auf OK, um die ausgewählten Looks zu löschen.

Mit dem Inhaltsprüftool suchen und ersetzen

Mit dem Inhaltsvalidierer können Sie auch nach den Namen von Modellen, Explores und Feldern suchen und diese ersetzen. Angenommen, Sie möchten ein Feld durch ein anderes ersetzen, obwohl kein Fehler vorliegt. Eine vollständige Liste der Elemente, die mit dem Inhaltsprüfer gesucht und ersetzt werden können, finden Sie im Abschnitt Namen für Felder, Ansichten, Explores und Modelle ersetzen.

So verwenden Sie den Content Validator als Tool zum Suchen und Ersetzen:

  1. Klicken Sie auf dem Bildschirm „Content Validator“ (Inhaltsprüfer) auf In allen Inhalten suchen und ersetzen, um das Dialogfeld In Inhalten aktualisieren zu öffnen.
  2. Wählen Sie den Typ des LookML-Elements aus, das Sie ändern möchten (Feld, Ansicht, Explore oder Modell).
  3. Geben Sie den Namen des Elements ein, das Sie ersetzen möchten.
  4. Geben Sie einen Ersatznamen für das Feld, die Ansicht, das explorative Datenanalyse oder das Modell ein.
  5. Klicken Sie auf Ersetzen, um die Änderung vorzunehmen.

Wichtige Punkte

Wiederholen Sie die Inhaltsvalidierung, um die Ergebnisse Ihrer Änderungen zu sehen.

Beachten Sie Folgendes zum Content Validator:

  • Sie können die Namen von Ansichten, explorativen Datenanalysen oder Modellen ändern, sie aber nicht vollständig entfernen. Im Abschnitt Feldnamen entfernen finden Sie eine Liste der Elemente, die Sie mit dem Content Validator entfernen können.
  • Tabellenberechnungen können nur auf Felder verweisen, die in der Abfrage eines Lookups oder einer Kachel enthalten sind. Wenn Sie also ein Feld aus der Abfrage eines Looks oder einer Kachel entfernen, es aber in einer Tabellenberechnung weiterhin verwendet wird, erhalten Sie einen neuen Fehler bei der Inhaltsüberprüfung.
  • Looks, die gelöscht wurden und sich im Ordner Papierkorb befinden, werden nicht validiert. Wenn Sie einen gelöschten Look prüfen möchten, muss Ihr Looker-Administrator ihn zuerst wiederherstellen.
  • Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihre gespeicherte LookML wider, auch wenn sie noch nicht in die Produktion verschoben wurde. Alle Änderungen, die Sie mit dem Inhaltsprüfer vornehmen, wirken sich jedoch auf Nutzer aus, die sich Inhalte im Produktionsmodus ansehen. Sie sollten zum Produktionsmodus wechseln, bevor Sie den Inhaltsvalidierer ausführen.