Inhaltsvalidierung

Der Content Validator sucht in LookML nach Modell-, Erkundungs- und Feldnamen, auf die in Ihren Looker-Inhalten verwiesen wird. Es ist ein sehr nützliches Tool, mit dem Sie Ihre LookML-Referenzen validieren, Fehler in LookML nach Änderungen beheben und die Namen Ihrer LookML-Elemente in Ihrem Projekt aktualisieren können.

Sie benötigen die Berechtigung develop, um den Content Validator verwenden zu können.

Wählen Sie im Menü Entwickeln die Option Inhaltsvalidierung aus, um den Content Validator zu öffnen:

Hier können Sie den Content Validator auf zwei Arten verwenden:

Vor der Verwendung des Inhaltsvalidators

Wenn Sie Änderungen mithilfe der Inhaltsvalidierung vornehmen, müssen Sie sehr vorsichtig sein. Der Content Validator hat keine Funktion zum Rückgängigmachen. Außerdem kann er viele Looks und Dashboards sowie die Links Entdecken von hier beeinflussen. Wenn Sie einen Fehler gemacht haben, sollten Sie ihn so schnell wie möglich korrigieren, bevor zusätzliche Änderungen die Isolierung der betroffenen Looks erschweren.

Berücksichtige bei der Verwendung des Inhaltsvalidatoren auch das Timing. Wenn Sie Entwicklungsänderungen in die Produktion übertragen, sollten Sie die betroffenen Looks und Kacheln ungefähr gleichzeitig korrigieren, damit sie für die Mindestdauer fehlerhaft sind. Wenn Sie Probleme mit dem Design und den Kacheln zu früh beheben, erscheinen diese je nach Ihrer Arbeit im Entwicklungsmodus für Nutzer so lange als fehlerhaft, bis Sie die Änderungen übernehmen. Ähnlich verhält es sich, wenn Sie das Korrigieren der Ansichten und Kacheln so lange verzögern, bis Sie die Änderungen übernommen haben. Die Änderungen an den Ansichten und Kacheln werden den Nutzern so lange als fehlerhaft angezeigt, bis Sie die Korrekturen vorgenommen haben.

Wenn Sie mit dem Content Validator Feldnamen ändern, die in Ihren Dashboards als Filter dienen, sehen Sie sich den Abschnitt Filter in Ihren Dashboard-Zeitplänen an und aktualisieren Sie die Filter nach Bedarf. Wenn eine geplante Dashboard-Auslieferung Filter enthält, die nicht mehr funktionieren (z. B. wenn sich das referenzierte Feld geändert hat), schlägt die geplante Zustellung fehl und der Inhaber des Zeitplans erhält eine Fehlermeldung, dass der Filter ungültig ist.

Seien Sie vorsichtig, wenn Sie den Content Validator verwenden, um eine Erkundung zu ändern, die in einer Kachel für zusammengeführte Ergebnisse verwendet wird, da die Inhaltsvalidierung Änderungen auf alle in der zusammengeführten Ergebniskachel enthaltenen Ergebnisse übernimmt. Beispielsweise können Sie den Inhaltsvalidator nicht verwenden, um den Modellnamen in einem einzelnen explorativen Analysetool in einer zusammengeführten Ergebniskachel zu ändern, ohne den Modellnamen in allen in den zusammengeführten Ergebnissen enthaltenen Explores zu ändern.

Fehler mit dem Content Validator beheben

Der Content Validator ist ein nützliches Tool, um Fehler zu finden und zu beheben, die sich aus den Änderungen in LookML ergeben. Wenn Sie beispielsweise einen Feldnamen von customer in user ändern, funktionieren Look oder Dashboard-Kacheln, die das Feld customer enthalten, nicht mehr (es sei denn, Sie haben den Parameter alias verwendet). Der Inhaltsvalidator 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, werden alle Verweise überprüft, die von Ihren Looks und Dashboards auf Ihre LookML-Modelle, Erkundungen, Ansichten und Felder verweisen. Es wird ein Fehler für alle Verweise auf Ihren Inhalt auf ein unbekanntes LookML-Objekt angezeigt.

Bei der Inhaltsvalidierung werden keine Fehler angezeigt, wenn...

  • Inhalte, für die du keine develop-Berechtigung hast Der Content Validator ist auf Ihre Berechtigungen beschränkt. Sie können den Content Validator daher nur für die Inhalte verwenden, für die Sie die Berechtigung develop haben (die Modelle, die Sie in der Looker-IDE sehen können). Informationen zu Modellberechtigungen finden Sie in der Dokumentation zu Rollen.
  • Sie wurden anscheinend gelöscht und befinden sich im Papierkorb. Wenn Sie einen gelöschten Look validieren möchten, muss Ihr Looker-Administrator zuerst den Look wiederherstellen.

Inhaltsprüfung durchführen

Lesen Sie den Abschnitt Bevor Sie den Content Validator verwenden, bevor Sie fortfahren. Der Content Validator kann Auswirkungen auf viele Teile Ihrer Looker-Inhalte haben. Daher sollten Sie vorab planen und berücksichtigen.

So validieren Sie LookML mit dem Inhaltsvalidator:

  1. Klicken Sie auf die Schaltfläche Validieren.
  2. Klicken Sie auf die Tabs Gruppieren nach, um die Gruppierung der Fehler zu ändern:
    • Fehler: Listet jeden Fehler auf und gruppiert die fehlerhaften Looker-Inhalte. Das ist nützlich, wenn Sie denselben Fehler in mehreren Inhalts gleichzeitig beheben möchten.
    • Ordner: Listen Sie jeden Ordner auf und gruppieren Sie die fehlerhaften Looker-Inhalte. Das ist nützlich, wenn Sie nur die Fehler in einem bestimmten Ordner beheben möchten.
    • Content: Hier wird jeder fehleranfällige Content aufgelistet und nach Fehlern gruppiert. Dies ist nützlich, wenn Sie alle Fehler in einem einzelnen Look, einer Kachel oder einem Filter usw. beheben möchten.
  3. Wenn Sie sich im Entwicklungsmodus befinden, ist es wichtig, die Auswirkungen einer Änderung des Aussehens und der Kacheln zu verstehen. Wenn Sie die Fehler beheben, bevor Sie Ihre funktionsgefährdenden Änderungen online stellen, wird es eine gewisse Zeit lang zu früh kommen, damit die Anzeigen bzw. Kacheln fehlerhaft sind. Looker gibt eine Warnmeldung aus, damit Sie sich dies merken können.
  4. In der Fehlertabelle werden alle Fehler zusammen mit einer Liste der Fehler und Kacheln angezeigt, die den Fehler enthalten, sowie das zugrunde liegende Modell und die Ursache für den Fehler. Über die Tabs Gruppieren nach rechts oben auf der Seite können Sie das Layout der Fehlertabelle ändern.
  5. Looker enthält je nach Fehlertyp für jede Zeile die Schaltflächen Ersetzen und/oder Entfernen. Diese Schaltflächen enthalten Funktionen, mit denen Sie diese Fehler beheben können. Weitere Informationen dazu finden Sie unten.

Ergebnisse der Inhaltsvalidierung ansehen

Die Ergebnisse der Inhaltsvalidierung zeigen Looker-Inhalte, die Modellnamen, Namen von Ansichten, Ansichtsnamen oder Feldnamen verwenden, die nicht vorhanden sind oder nicht gefunden werden können. Im Abschnitt Content Validator zur Fehlerbehebung verwenden finden Sie Details zu den LookML-Elementen, die vom Content Validator gefunden und validiert werden können.

Das Symbol neben dem Namen des Inhalts kennzeichnet den Inhaltstyp:

  • – Dashboard-Kachel
  • – Dashboard-Benachrichtigung
  • – Zeitplan für ein Dashboard oder einen Look festlegen
  • : Nach einem Dashboard oder einem Feld auf einer Kachel filtern, die einen Dashboard-Filter überwacht. Informationen zum Konfigurieren von Kacheln zum Anhören von Dashboard-Filtern finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

Die Validierungsergebnisse basieren auf dem LookML, das in dem Modus verfügbar ist, in dem Sie die Validierung ausführen. Wenn Sie sich im Produktionsmodus befinden, spiegeln die Validierungsergebnisse alle LookMLs wider, die in die Produktion übertragen wurden. Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihre gespeicherte LookML wider, selbst wenn sie nicht in die Produktion übertragen wurde.

Fehler können auf absichtliche Änderungen in Ihrer LookML-Datei oder auf einen Tippfehler oder einen fehlenden Join zurückzuführen sein.

Sie können Fehler mithilfe der Schaltflächen in jeder Zeile der Fehlertabelle anpassen:

Looker enthält für jeden Fehler die Schaltfläche Ersetzen. Im Abschnitt Namen für Felder, Ansichten, explorative Datenanalysen und Modelle ersetzen unten erfahren Sie, wie Sie Namen mit dem Inhaltsvalidator ersetzen. Bei Fehlern mit Feldnamen im Bereich Daten eines Look oder einer Kachel wird in Looker auch die Schaltfläche Entfernen angezeigt. Im Abschnitt Feldnamen entfernen unten erfahren Sie, wie Sie Namen mit dem Inhaltsvalidator entfernen können.

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

  • Wenn Sie nach Fehler gruppieren, werden die Schaltflächen auf alle Vorkommen dieses Fehlers in allen Looks und Kacheln auf Ihrer Looker-Instanz angewendet, sodass Sie alle Vorkommnisse in einem einzigen Vorgang beheben können.
  • Wenn Sie nach Ordner oder Inhalt gruppieren, gelten die Schaltflächen nur für das Auftreten eines Fehlers in einem einzigen Look oder einer Kachel. So können Sie jedes Auftreten des Fehlers separat betrachten.

Hier ein Beispiel, bei dem die Tabelle nach Fehler gruppiert ist, sodass die Schaltflächen alle Instanzen dieses Fehlers betreffen:

In diesem Beispiel wird die Tabelle nach Inhalt gruppiert, sodass die Schaltflächen nur die eine Instanz des Fehlers bei einem einzelnen Inhalt betreffen:

Außerdem haben Sie beim Gruppieren nach Inhalte die zusätzliche Option, Looks zu löschen.

Namen für Felder, Ansichten, explorative Datenanalysen und Modelle ersetzen

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

Bei jedem dieser Fehler können Sie mit dem Tool zur Inhaltsvalidierung ein Attribut des Inhalts ersetzen, das dem allgemeinen Attribut entspricht oder allgemeiner ist:

  • Wenn ein Feld fehlerhaft ist, können Sie es ersetzen oder entfernen oder den Ansichts-, Erkundungs- oder Modellnamen ersetzen.
  • Wenn ein Name zum Erkunden fehlerhaft ist, können Sie den Namen „Erkunden“ oder den Namen des Modells ersetzen.
  • Wenn ein Modellname fehlerhaft ist, können Sie ihn 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. Klicken Sie auf eine Gruppieren nach-Einstellung, um auszuwählen, wie Fehler gruppiert werden sollen. In diesem Beispiel wird die Gruppierung nach Fehler vorgenommen, sodass wir mehrere Elemente gleichzeitig anpassen können.

  3. Klicken Sie in der Fehlertabelle neben dem Fehler, den Sie korrigieren möchten, auf die Schaltfläche Ersetzen.

  4. Wählen Sie im Dialogfeld den Typ des LookML-Elements aus, das Sie ändern möchten: Feld, Ansicht, Erkunden oder Modell. Looker zeigt die entsprechenden Optionen für jeden Fehler an.

  5. Prüfen Sie den Namen des Elements, das Sie ersetzen möchten. Der Content Validator füllt diese Angaben automatisch aus.

  6. Geben Sie den neuen Namen des Artikels ein.

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

  8. Optional können Sie die Häkchen neben den aufgelisteten Elementen entfernen, damit der Name unverändert bleibt.

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

Feldname entfernen

Bei Fehlern mit Feldnamen im Bereich Daten eines Look oder einer Kachel wird in der Fehlertabelle rechts neben dem Fehler die Schaltfläche Entfernen angezeigt. Mit dem Content Validator können Sie folgende Felder entfernen:

  • Im Abschnitt Daten einer Look- oder Dashboard-Kachel
  • In Visualisierungskonfigurationen referenziert, z. B. im Bereich Anpassungen auf dem Tab Reihe für Säulendiagramme
  • Referenziert durch eine Dashboard-Kachel, um einen Dashboard-Filter anzuhören (wird auf dem Tab Zu aktualisierende Kacheln des Fensters für die Filterkonfiguration konfiguriert, wie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten beschrieben)

Sie können den Inhaltsvalidator nicht verwenden, um Felder aus benutzerdefinierten Filtern, benutzerdefinierten Feldern oder Tabellenberechnungen zu entfernen, da normalerweise zusätzliche Änderungen erforderlich sind, damit der Ausdruck funktioniert. Verwenden Sie stattdessen die Fehlermeldungen zur Inhaltsvalidierung, um Stellen zu finden, an denen benutzerdefinierte Filter, benutzerdefinierte Felder und Tabellenberechnungsausdrücke korrigiert werden müssen. Ändern Sie dann den Ausdruck gegebenenfalls.

  1. Klicken Sie auf Validieren, um den Content Validator auszuführen.
  2. Klicken Sie auf eine Gruppieren nach-Einstellung, um auszuwählen, wie Fehler gruppiert werden sollen. In diesem Beispiel wird die Gruppierung nach Fehler vorgenommen, sodass wir mehrere Elemente (Looks, Kacheln oder beides) gleichzeitig anpassen können.

  3. Klicken Sie in der Fehlertabelle neben dem Feldfehler, den Sie korrigieren möchten, auf die Schaltfläche Entfernen.

  4. Bestätigen Sie den Namen des Elements, das Sie entfernen möchten. Der Content Validator füllt diese Angaben automatisch aus.

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

  6. Sie können auch die Häkchen neben allen Looks oder Kacheln entfernen, um den 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 können Sie den Inhaltsvalidator zum Löschen von Looks verwenden:

  1. Klicken Sie auf Validieren, um den Content Validator auszuführen.
  2. Gruppieren Sie die Tabelle nach Content.
  3. Klicken Sie in der Fehlertabelle neben dem Look oder Look, das 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 das ausgewählte Design zu löschen.

Wenn Sie einen Look versehentlich löschen, kann Ihr Looker-Administrator möglicherweise ihn für Sie wiederherstellen. Looker speichert gelöschte Inhalte im Papierkorb, bis Ihr Looker-Administratorteam den Papierkorb während des Wartungsprozesses leert.

Mit dem Content Validator Inhalte suchen und ersetzen

Mit dem Inhaltsvalidierungstool können Sie auch die Namen von Modellen, Entdeckungen und Feldern suchen und ersetzen. Sie können beispielsweise festlegen, dass ein Feld einem anderen vorgezogen wird, und dieses Feld in Ihrem Projekt ersetzen, obwohl ein Fehler vorliegt. Eine vollständige Liste der Elemente, die im Content Validator durchsucht/ersetzt werden können, finden Sie oben im Abschnitt Namen für Felder, Ansichten, explorative Datenanalysen und Modelle ersetzen.

Lesen Sie den Abschnitt Bevor Sie den Content Validator verwenden, bevor Sie fortfahren. Der Content Validator kann Auswirkungen auf viele Teile Ihrer Looker-Inhalte haben. Daher sollten Sie vorab planen und berücksichtigen.

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

  1. Klicken Sie auf dem Bildschirm „Inhaltsvalidierung“ auf Suchen und in allen Inhalten ersetzen.

  2. Wählen Sie den Typ des LookML-Elements aus, das Sie ändern möchten (Feld, Ansicht, Entdecken oder Modell).

  3. Geben Sie unter Name den Namen des Elements ein, das Sie ersetzen möchten.

  4. Geben Sie unter Ersatzname einen Namen für das Feld, die Ansicht, das Modell oder das Modell ein.

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

Wichtige Punkte

Planen Sie die Inhaltsvalidierung noch einmal, um die Ergebnisse der von Ihnen vorgenommenen Korrekturen zu sehen.

Hinweise zur Inhaltsvalidierung:

  • Bei Ansichten, explorativen Datenanalysen oder Modellen können Sie die Namen ändern, aber die Namen nicht vollständig entfernen. Im Abschnitt Feldnamen entfernen finden Sie eine Liste der Elemente, die Sie mit dem Inhaltsvalidator entfernen können.
  • Tabellenberechnungen können nur auf Felder verweisen, die in der Abfrage eines Look oder einer Kachel enthalten sind. Wenn Sie ein Feld aus einer Abfrage oder einer Tile-Abfrage entfernen, das Feld aber weiterhin in der Tabellenberechnung verwendet wird, erhalten Sie einen neuen Fehler bei der Inhaltsvalidierung.
  • Gelöschte Dateien, die sich auf der Seite Papierkorb befinden, werden nicht validiert. Wenn Sie einen gelöschten Look validieren möchten, muss Ihr Looker-Administrator zuerst den Look wiederherstellen.
  • Wenn Sie sich im Entwicklungsmodus befinden, spiegeln die Validierungsergebnisse Ihr gespeichertes LookML wider, auch wenn es nicht in die Produktion übertragen wurde. Alle Änderungen, die Sie mit dem Inhaltsvalidator vornehmen, wirken sich jedoch auf Nutzer aus, die sich Inhalte im Produktionsmodus ansehen. Bevor Sie den Content Validator ausführen, sollten Sie in den Produktionsmodus wechseln.