Inhaltsprüfung

Der Inhaltsvalidator sucht in Ihrer LookML nach den Modell-, Explore- und Feldnamen, auf die in Ihren Looker-Inhalten verwiesen wird. Es ist ein nützliches Tool zum Validieren Ihrer LookML-Referenzen, zum Beheben von Fehlern in Ihrem LookML-Code, nachdem Sie Änderungen vorgenommen haben, und zum Aktualisieren der Namen von LookML-Elementen in Ihrem gesamten Projekt.

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

Wenn Sie den Content Validator öffnen möchten, wählen Sie im linken Navigationsbereich im Menü Entwickeln die Option Inhaltsvalidierung aus. Von hier aus haben Sie zwei Möglichkeiten, den Content Validator zu verwenden:

Vor der Verwendung des Content Validators

Sie müssen äußerst vorsichtig sein, wenn Sie Änderungen mithilfe der Inhaltsvalidierung vornehmen. Der Content Validator hat keine Funktion zum Rückgängigmachen und kann sich auf viele Looks und Dashboards sowie die Links Von hier ansehen 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 bei der Verwendung des Content Validators auch Ihren Zeitplan. 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 aufgrund Ihrer Arbeit im Entwicklungsmodus zu früh korrigieren, werden sie für Nutzer als fehlerhaft angezeigt, bis Sie Ihre Änderungen übertragen. Wenn Sie die Fehlerbehebung für Looks und Ansichten erst lange nach dem Pushen der Änderungen vornehmen, werden sie Nutzern als fehlerhaft angezeigt, bis Sie sie behoben 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 Content Validator listet alle Verweise auf das Feld customer auf und bietet eine einfache Möglichkeit, den Fehler zu beheben.

Wenn Sie den Content Validator ausführen, überprüft er alle Verweise, die Ihre Looks und Dashboards auf Ihre LookML-Modelle, Explores, Ansichten und Felder herstellen, und gibt einen Fehler für alle Verweise Ihres Inhalts auf ein unbekanntes LookML-Objekt aus.

Der Inhaltsvalidierer zeigt keine Fehler für Folgendes an:

  • Inhalte, für die Sie keine develop-Berechtigung haben. Die Inhaltsvalidierung ist auf Ihre Berechtigungen beschränkt. Sie können sie also nur für den Inhalt verwenden, für den Sie die Berechtigung develop haben (die Modelle, die Sie in der Looker-IDE aufrufen können). Informationen zu Berechtigungen für Modelle finden Sie auf der Dokumentationsseite Rollen.
  • Looks, die gelöscht wurden und sich im Papierkorb befinden. Wenn Sie einen gelöschten Look validieren möchten, muss Ihr Looker-Administrator ihn zuerst wiederherstellen.

Content Validator verwenden

So validieren Sie Ihren LookML-Code mit dem Content Validator:

  1. Klicke auf Validieren.
  2. Wählen Sie die Tabs Gruppieren nach aus, um die Gruppierung von Fehlern zu ändern:
    • Fehler: Hier werden alle Fehler aufgelistet und die Looker-Inhalte, in denen sie auftreten, gruppiert. Dies ist nützlich, wenn Sie denselben Fehler in mehreren Inhalten gleichzeitig beheben möchten.
    • Ordner: Listen Sie die einzelnen Ordner auf und gruppieren Sie den fehlerhaften Looker-Inhalt. Dies ist nützlich, wenn Sie nur die Fehler in einem bestimmten Ordner beheben möchten.
    • Inhalte: Geben Sie alle Inhalte mit Fehlern auf und gruppieren Sie die Fehler. Dies ist nützlich, wenn Sie alle Fehler in einem einzigen Look, Tile, Filter usw. beheben möchten.
  3. Wenn Sie sich im Entwicklungsmodus befinden, wird in Looker eine Warnmeldung angezeigt. Es ist wichtig, die Auswirkungen von Änderungen an Designs und Kacheln zu verstehen. Wenn Sie „korrigieren“ bevor Sie Ihre funktionsgefährdenden Änderungen live schalten, wird es eine gewisse Zeit dauern, bis die Fehlerbehebung verfrüht ist, sodass Nutzende fehlerhafte Looks oder Kacheln sehen. Die Warnmeldung hilft Ihnen, sich dies zu merken.
  4. In der Fehlertabelle werden alle Fehler zusammen mit einer Liste der Looks und Tiles, die den Fehler enthalten, sowie das zugrunde liegende Modell und Explore, die den Fehler verursachen, angezeigt. Über die Tabs Nach oben rechts auf der Seite können Sie das Layout der Fehlertabelle ändern.
  5. Je nach Fehlertyp bietet Looker für jede Zeile die Schaltflächen Ersetzen und/oder Entfernen an. Mit diesen Schaltflächen können Sie die Fehler beheben. Weitere Informationen finden Sie unter Fehler mit dem Inhaltsvalidierer beheben.

Ergebnisse der Inhaltsvalidierung ansehen

Die Ergebnisse der Inhaltsüberprüfung enthalten 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.

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, die auf Dashboard-Filter reagieren, finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

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 den gesamten LookML-Code wider, der in die Produktion übertragen wurde. Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihre gespeicherte LookML wider, auch wenn sie noch nicht in die Produktion verschoben wurde.

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

Sie können Fehler in jeder Zeile der Fehlertabelle mit den Schaltflächen Ersetzen und Entfernen anpassen. 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 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. Im Abschnitt Feldnamen mit dem Inhaltsvalidierer entfernen weiter unten auf dieser Seite erfahren Sie, wie Sie Namen mit dem Inhaltsvalidierer entfernen.

Je nach Einstellung für Nach werden die Schaltflächen 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, gelten die Schaltflächen für ein einzelnes Auftreten des Fehlers in einem einzelnen Look oder einer einzelnen Kachel. So können Sie jedes Auftreten des Fehlers separat betrachten.

Eine Fehlertabelle ist beispielsweise nach Fehler gruppiert und zeigt drei Inhaltsinstanzen mit einem unbekannten Explore mit dem Namen customers an. 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 einzelne Inhalte mehrere Fehler vorliegen. Eine Fehlertabelle ist beispielsweise nach Inhalt gruppiert und enthält einen Inhalt namens 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 Inhalt 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 dem fehlerhaften oder allgemeineren Attribut entspricht:

  • Wenn ein Feld fehlerhaft ist, können Sie das Feld entweder ersetzen oder entfernen oder den Ansichts-, Explore- oder Modellnamen ersetzen.
  • Wenn ein Explore-Name zu Fehlern führt, können Sie den Explore-Namen oder den Modellnamen ersetzen.
  • Wenn ein Modellname fehlerhaft ist, können Sie den Modellnamen ersetzen.

So verwenden Sie den Content Validator, um die Namen von Elementen in Ihrem Modell zu ersetzen:

  1. Klicken Sie auf Validieren, um den Content Validator auszuführen.
  2. Wählen Sie eine Einstellung unter 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. Prüfen Sie im Abschnitt Name den Namen des Elements, das Sie ersetzen möchten. Diese Informationen werden vom Content Validator automatisch eingefügt.

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

  7. Wenn Sie eine Gruppierung nach Fehler vorgenommen haben und mehrere Elemente betroffen sind, können Sie auf Inhalt anzeigen klicken, um eine Liste der Elemente aufzurufen, die vom Content Validator 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 Abschnitt Data eines Looks oder einer Tile wird rechts neben dem Fehler in der Fehlertabelle die Schaltfläche Entfernen angezeigt. Mit dem Content Validator können Sie folgende Felder entfernen:

  • 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 Dashboard-Tile referenziert, um einen Dashboard-Filter anzuhören. Dies wird auf dem Tab Zu aktualisierende Tiles des Filterkonfigurationsfensters konfiguriert, wie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten beschrieben.

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 Tabellenkalkulationsausdrücke 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 unter Gruppieren nach aus, um festzulegen, wie Fehler gruppiert werden. Sie können beispielsweise nach Fehler gruppieren, um mehrere Elemente (Looks, Kacheln oder beides) gleichzeitig anzupassen.

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

  4. Prüfen Sie im Dialogfeld Feld aus Inhalt entfernen im Abschnitt Feld 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 Kontrollkästchen neben Looks oder Tiles deaktivieren, um deren 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 Content Validator auszuführen.
  2. Gruppieren Sie die Tabelle nach Inhalt.
  3. Klicken Sie in der Fehlertabelle neben dem Look oder den Looks, die Sie löschen möchten, auf das Kästchen Auswählen.
  4. Klicken Sie auf Alle ausgewählten Looks löschen.
  5. Klicken Sie im Bestätigungsfeld auf OK, um den ausgewählten Look oder die ausgewählten Looks zu löschen.

Mit dem Inhaltsprüftool suchen und ersetzen

Der Content Validator kann auch verwendet werden, um die Namen von Modellen, Explores und Feldern zu suchen und zu ersetzen. Angenommen, Sie möchten ein Feld durch ein anderes ersetzen, obwohl kein Fehler vorliegt. Die vollständige Liste der Elemente, nach denen der Content Validator suchen und ersetzen kann, 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 "Inhaltsvalidierung" auf Suchen und In „Alle Inhalte“ ersetzen, um das Dialogfeld Im Inhalt aktualisieren zu öffnen.
  2. Wählen Sie den Typ des LookML-Elements aus, das Sie ändern möchten (Feld, Datenansicht, 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 Explore 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 beim Content Validator Folgendes:

  • Sie können die Namen von Ansichten, Explores oder Modellen ändern, aber nicht gänzlich 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 Tile entfernen, dieses Feld aber noch in einer Tabellenkalkulation verwendet wird, erhalten Sie einen neuen Inhaltsprüfungsfehler.
  • Looks, die gelöscht wurden und sich auf der Seite 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.