Inhaltsprüfung

Mit der Inhaltsvalidierung wird in Ihrem LookML-Code nach dem Modell, dem Explore und den Feldnamen gesucht, auf die im Looker-Inhalt 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 Content Validator verwenden zu können.

Wählen Sie zum Öffnen des Content Validators im linken Navigationsbereich im Menü Entwickeln die Option Content Validator aus. Von hier aus haben Sie zwei Möglichkeiten, den Content Validator zu verwenden:

Vor der Verwendung des Content Validators

Sie müssen extremely 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 Ihnen ein Fehler unterläuft, sollten Sie versuchen, ihn so schnell wie möglich zu beheben, bevor weitere Änderungen die Isolierung der betroffenen Looks erschweren.

Berücksichtigen Sie bei der Verwendung des Content Validators auch Ihren Zeitplan. Wenn Sie Entwicklungsänderungen in die Produktion übertragen, sollten Sie die betroffenen Looks und Tiles ungefähr zur gleichen Zeit korrigieren, damit sie für die geringstmögliche Zeit fehlerhaft sind. 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 Korrektur von Looks und Kacheln erst lange nach dem Übertragen der Änderungen verzögern, werden die Looks und Tiles den Nutzenden so lange als fehlerhaft angezeigt, bis Sie sie korrigieren.

Fehler mit dem Content Validator beheben

Der Content Validator ist ein nützliches Tool zum Auffinden und Beheben von Fehlern, die aus Änderungen in Ihrem LookML-Code resultieren. Wenn Sie beispielsweise einen Feldnamen von customer in user ändern, funktionieren alle Looks oder Dashboard-Tiles, 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, validiert 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.

In folgenden Fällen werden beim Content Validator keine Fehler angezeigt:

  • 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 Modellberechtigungen 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: Listen Sie alle Fehler auf und gruppieren Sie den Looker-Inhalt mit dem Fehler. 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.
    • Inhalt: Listen 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, gibt Looker eine Warnmeldung aus. Es ist wichtig, die Auswirkungen der Änderung von Looks und Tiles zu verstehen. Wenn Sie sie „beheben“, bevor Sie die funktionsgefährdenden Änderungen live schalten, wird die Korrektur eine bestimmte Zeit lang verfrüht, sodass Nutzer 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. Mit den Tabs Gruppieren nach rechts oben 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. Diese Schaltflächen bieten Funktionen zum Beheben von Fehlern und werden ausführlicher unter Fehler mit dem Content Validator beheben beschrieben.

Ergebnisse der Inhaltsvalidierung ansehen

Die Ergebnisse der Inhaltsvalidierung zeigen Looker-Inhalte, die Modellnamen, Explore-Namen, Ansichtsnamen oder Feldnamen verwenden, die nicht vorhanden oder nicht gefunden werden können. Im Abschnitt Content Validator zum Beheben von Fehlern verwenden finden Sie weitere Informationen zu den LookML-Elementen, die der Content Validator finden und validieren kann.

Das Symbol neben dem Namen des Inhalts kennzeichnet den Inhaltstyp:

  • Kachel auf dem Dashboard-Symbol. – Dashboard-Kachel
  • Benachrichtigung auf Dashboardsymbol. – Dashboard-Benachrichtigung
  • Auf Dashboard planen oder auf dem Look-Symbol planen. – Für ein Dashboard oder einen Look planen
  • Auf Dashboardsymbol filtern.: Filter für ein Dashboard oder ein Feld in einer Tile, das einen Dashboard-Filter überwacht. Informationen zum Konfigurieren von Tiles zur Überwachung von Dashboard-Filtern finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

Validierungsergebnisse basieren auf dem LookML-Code, der in dem Modus verfügbar ist, in dem Sie sich beim Ausführen des Validators befinden. 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 Ihr gespeichertes LookML wider, auch wenn es noch nicht in die Produktion übertragen wurde.

Fehler können durch beabsichtigte Änderungen in Ihrem LookML-Code sowie durch einen Tippfehler oder einen fehlenden Join verursacht werden.

Mit den Schaltflächen Ersetzen und Entfernen in jeder Zeile der Fehlertabelle können Sie Fehler korrigieren:

  • Ersetzen: In Looker gibt es für jeden Fehler die Schaltfläche Ersetzen. Im Abschnitt Namen von Feldern, Ansichten, Explores und Modellen ersetzen weiter unten auf dieser Seite erfahren Sie, wie Sie Namen mit dem Content Validator ersetzen.
  • Entfernen: Bei Fehlern mit Feldnamen im Abschnitt Daten eines Looks oder einer Kachel wird in Looker auch die Schaltfläche Entfernen angezeigt. Im Abschnitt Feldnamen entfernen weiter unten auf dieser Seite erfahren Sie, wie Sie Namen mit dem Content Validator entfernen.

Je nach Ihrer Einstellung für Gruppieren nach gelten die Schaltflächen für ein einzelnes Element (Design oder Kachel) oder für mehrere Elemente:

  • Wenn Sie nach Fehler gruppieren, gelten die Schaltflächen für alle Vorkommen dieses Fehlers in allen Looks und Tiles auf 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. Die für die drei Inhaltselemente bereitgestellte Aktion lautet Ersetzen. Das Klicken auf Ersetzen würde alle drei Instanzen des Inhalts mit dem Fehler 3 x Unknown explore 'customers' betreffen.

In einigen Fällen können für einzelne Inhalte mehrere Fehler auftreten. Eine Fehlertabelle ist beispielsweise nach Inhalt gruppiert und enthält einen Inhalt namens Bestelldetails. In der Spalte Fehler werden vier Fehler vom Typ Unknown field angezeigt. Jeder Fehler hat in der Spalte Aktionen eigene Aktionsschaltflächen für Ersetzen und Entfernen.

Wenn Sie nach Inhalt gruppieren, haben Sie zusätzlich die Möglichkeit, Looks zu löschen.

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

Die Ergebnisse der Inhaltsprüfung enthalten eine Schaltfläche Ersetzen für die folgenden Elementtypen, sodass 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 fehlerhaft ist, 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 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 Update in Content (Im Inhalt aktualisieren) im Abschnitt Type (Typ) den Typ des LookML-Elements aus, das Sie ändern möchten: Feld, Ansicht, Explore oder Modell. Looker zeigt für jeden Fehler die entsprechenden Optionen an.

  5. Prüfen Sie im Abschnitt Name den Namen des Elements, das Sie ersetzen möchten. Der Content Validator trägt diese Informationen automatisch ein.

  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 Kontrollkästchen neben den aufgelisteten Elementen deaktivieren, um deren 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 Abschnitt Data (Daten) einer Look- oder Dashboard-Tile
  • Verweist in Visualisierungskonfigurationen, z. B. im Bereich Anpassungen auf dem Tab Reihen 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 Tabellenkalkulationen entfernen, da Sie normalerweise 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 Content Validator 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, Kacheln 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 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. Der Content Validator füllt dieses Feld automatisch aus.

  5. Wenn Sie die Ansicht nach Fehler gruppiert haben und mehrere Elemente vorhanden sind (Looks, Kacheln oder beides), können Sie auf Inhalt anzeigen klicken, um eine Liste der Elemente aufzurufen, die vom Content Validator aktualisiert werden.

  6. Optional können Sie die Kontrollkästchen neben allen 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, können Sie Looks in der Tabelle 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.

Suchen und Ersetzen mit dem Content Validator

Der Content Validator kann auch verwendet werden, um die Namen von Modellen, Explores und Feldern zu suchen und zu ersetzen. Sie können beispielsweise ein Feld einem anderen vorziehen und dieses Feld in Ihrem Projekt ersetzen, auch wenn 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 zum Suchen und Ersetzen:

  1. Klicken Sie auf dem Bildschirm „Inhaltsvalidierung“ auf Unter „Alle Inhalte“ suchen und 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, 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 Explore oder das Modell ein.
  5. Klicken Sie auf Ersetzen, um die Änderung vorzunehmen.

Wichtige Punkte

Planen Sie, die Inhaltsprüfung noch einmal auszuführen, um die Ergebnisse Ihrer Korrekturen 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.
  • Tabellenkalkulationen können nur auf Felder verweisen, die in der Abfrage eines Looks oder einer Tile 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 validieren möchten, muss Ihr Looker-Administrator ihn zuerst wiederherstellen.
  • Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihren gespeicherten LookML-Code auch dann wider, wenn er noch nicht in die Produktion übertragen wurde. Änderungen, die Sie mit dem Content Validator vornehmen, wirken sich jedoch auf Nutzer aus, die Inhalte im Produktionsmodus ansehen. Es empfiehlt sich, in den Produktionsmodus zu wechseln, bevor Sie den Content Validator verwenden.