Looker Data Dictionary verwenden

Das Looker Data Dictionary unterscheidet sich vom Data Dictionary Block.

Um alle Funktionen der Looker Data Dictionary-Erweiterung nutzen zu können, sollten Administratoren die Looker Data Dictionary-Anwendung auf Version 2.0.0 oder höher aktualisieren.

Das Looker Data Dictionary ist eine Erweiterung – eine Webanwendung, die mit Looker-Komponenten erstellt wurde –, die mit dem Looker Extension Framework entwickelt und über den Looker Marketplace bereitgestellt wird.

Die Looker Data Dictionary-Erweiterung bietet eine zentrale Oberfläche, über die Sie alle Looker-Felder und -Beschreibungen durchsuchen können. Diese Erweiterung kann für folgende Aufgaben verwendet werden: * Stellen Sie ein durchsuchbares Verzeichnis für alle Metriken und Beschreibungen bereit, damit Nutzer die entsprechende Dimension oder den Messwert für die Analyse identifizieren können. * Leichtere Identifizierung und Lokalisierung der eindeutigen Messwerte für externe Stakeholder für ihr Unternehmen * Prüfen Sie LookML-Modelle, um festzustellen, ob einheitliche Benennungskonventionen eingehalten werden, ob es redundante Felder gibt oder ob Felder mit Beschreibungen versehen sind. * Fügen Sie Kommentare zu bestimmten Feldern hinzu und geben Sie sie frei (wenn Ihre Looker Data Dictionary-Anwendung Version 2.0.0 oder höher ist).

Damit Nutzer auf das Looker-Datenlexikon zugreifen und es verwenden können, müssen Looker-Administratoren die folgenden Schritte ausführen:

  1. Aktivieren Sie die entsprechenden Funktionen.
  2. Installieren Sie die Looker Data Dictionary-Erweiterung.
  3. Weisen Sie Berechtigungen für den Zugriff auf das Looker-Datenlexikon zu.

Sobald die Erweiterung für Nutzer verfügbar ist, haben Sie folgende Möglichkeiten:

  1. Rufen Sie das Looker Data Dictionary auf.
  2. Metadaten Ihres Modells ansehen

Looker Data Dictionary installieren

Vor der Installation des Looker Data Dictionary aus dem Marketplace müssen Looker-Administratoren die folgenden Funktionen aktivieren:

  • Marketplace: Zugriff auf den Looker Marketplace (standardmäßig aktiviert)
  • Extension Framework: Zum Bereitstellen von Erweiterungen, die mit dem Erweiterungs-Framework von Looker entwickelt wurden (standardmäßig aktiviert)

Wenn Sie Anwendungen und Tools wie Erweiterungen aus dem Marketplace installieren möchten, benötigen Sie die Berechtigungen develop, manage_models und deploy.

Eine Anleitung zum Installieren eines Tools aus dem Looker-Marktplatz finden Sie in der Dokumentation Looker-Marktplatz verwenden. Sie können dafür sorgen, dass Sie immer die neueste Version des Datenlexikons haben. Rufen Sie dazu den Looker Marketplace auf, wählen Sie Verwalten und dann neben der Erweiterung die Schaltfläche Aktualisieren aus.

Gewähren von Berechtigungen für den Zugriff auf das Looker Data Dictionary

Nachdem das Looker-Datenlexikon installiert wurde, wird der Liste der verfügbaren Modelle auf den Seiten Neues Modellset und Modellset bearbeiten automatisch ein Modell namens data-dictionary hinzugefügt. Diese Seiten sind über den Bereich Verwaltung auf der Seite Rollen zugänglich.

Looker-Administratoren müssen Nutzern explore- oder develop-Berechtigungen für den Zugriff auf das data-dictionary-Modell und alle Modelle gewähren, die sie im Data Dictionary untersuchen müssen. Informationen dazu, wie Sie Nutzern Berechtigungen für den Zugriff und die Verwendung von Erweiterungen gewähren, finden Sie auf der Dokumentationsseite Berechtigungen für Looker-Erweiterungen festlegen.

Berechtigungen zum Interagieren mit Feldkommentaren gewähren

Feldkommentare geben Nutzern die Möglichkeit, Kontext zu Felddefinitionen hinzuzufügen, ohne LookML aktualisieren zu müssen. Standardmäßig können alle Nutzer mit Zugriff auf die Datenwörterbuch-Erweiterung alle Kommentare sehen und ihre eigenen Kommentare hinzufügen, bearbeiten und löschen.

Bei Bedarf können Looker-Administratoren verwalten, wie Nutzer mit der Kommentarfunktion für Felder interagieren. Dazu erstellen sie im Admin-Bereich auf der Seite Gruppen bestimmte Nutzergruppen und weisen diesen Gruppen Nutzer zu. Weitere Informationen zum Zuweisen von Nutzern zu Gruppen finden Sie auf der Dokumentationsseite Google Groups.

Die Nutzergruppen müssen mit den vordefinierten Namen erstellt werden, die in der Spalte „Gruppenname“ der folgenden Tabelle aufgeführt sind. Die Tabelle enthält auch die vordefinierten Berechtigungen, die den Nutzern der einzelnen Gruppen zugewiesen werden.

Gruppenname Berechtigungen
marketplace_data_dictionary_comments_disabled Nutzer können keine Kommentare sehen oder anderweitig mit ihnen interagieren. Alle Kommentarfunktionen sind deaktiviert. Die Berechtigungen dieser Gruppe haben immer Vorrang vor denen anderer Gruppen. Nutzer, die der Gruppe disabled angehören, haben keinen Zugriff auf die Kommentarfunktion, auch wenn sie einer anderen Gruppe mit höheren Berechtigungen angehören.
marketplace_data_dictionary_comments_reader Der Nutzer kann vorhandene Kommentare sehen, aber keine hinzufügen.
marketplace_data_dictionary_comments_writer Nutzer können alle Kommentare ansehen, neue Kommentare hinzufügen und eigene bearbeiten oder löschen. Dies ist die Standardberechtigung.
marketplace_data_dictionary_comments_manager Nutzer können alle Kommentare sehen, neue Kommentare hinzufügen und alle Kommentare bearbeiten oder löschen.

Wenn ein Nutzer keiner dieser Gruppen angehört, wird standardmäßig writer verwendet. Wenn ein Nutzer mehreren Gruppen zugewiesen ist (ausgenommen marketplace_data_dictionary_comments_disabled), hat die höhere Berechtigung Vorrang.

Änderungen an einer Kommentargruppe, z. B. das Hinzufügen oder Entfernen eines Nutzers, die über die Seite Gruppen im Admin-Steuerfeld vorgenommen werden, werden nach einer vollständigen Aktualisierung der Data Dictionary-Seite oder nachdem der Nutzer eine andere Option ausgewählt und dann zur Datenwörterbuch-Seite zurückgekehrt ist, wirksam.

Sie können das Datenwörterbuch über die Liste der installierten Anwendungen und Erweiterungen in der linken Seitenleiste aufrufen.

Modellmetadaten mit dem Looker Data Dictionary ansehen

Im Looker Data Dictionary können Nutzer mit explore-Berechtigungen für ein Modell dieses Modell auswählen und die zugehörigen Metadaten aufrufen, einschließlich der Explores und der Felder jedes Explores, gruppiert nach Ansicht. Im Looker Data Dictionary werden die Explores des ausgewählten Modells in der linken Seitenleiste und die Ansichten und Felder des ausgewählten Explores im Hauptteil der Seite angezeigt.

Nutzer können die Seitenleiste minimieren, indem sie auf das Symbol < klicken.

Das Looker Data Dictionary zeigt die folgenden Informationen an:

  1. Der Name des ausgewählten Modells
  2. Die Liste der im ausgewählten Modell enthaltenen Explores
  3. Das ausgewählte Explore
  4. Ein Textfeld zum Filtern der Felder in einem Explore
  5. Schnellfilter zum Eingrenzen angezeigter Felder basierend auf ausgewählten Merkmalen
  6. Der Name der Ansicht
  7. Metadaten zu den einzelnen Feldern. Über die Schaltfläche Ansichtsoptionen können Sie festlegen, welche Metadaten angezeigt werden. Die vollständigen Metadaten des Felds finden Sie im Feldprofil.
  8. Zeilen mit Metadaten für jedes Feld in einer bestimmten Ansicht
  9. Navigation zum Explore in der Looker-Benutzeroberfläche

Modell und Explore auswählen

Die Drop-down-Liste Modell auswählen enthält alle Modelle, für die ein Nutzer die Berechtigung explore hat. Wenn Sie im Drop-down-Menü Modell auswählen ein Modell auswählen, wird in der linken Seitenleiste eine Liste der Explores dieses Modells angezeigt.

Sie können auch im ausgewählten Modell nach einem bestimmten Explore suchen, indem Sie im Suchfeld Modell suchen einen Suchbegriff eingeben. Die Liste der Explores wird so gefiltert, dass nur die Ergebnisse angezeigt werden, die Ihren Suchbegriffen entsprechen.

Wählen Sie den Namen eines Explores aus, um die Felder, gruppiert nach Ansicht, im Hauptteil der Seite anzuzeigen.

Sie können auch rechts oben auf die Schaltfläche Expl. Datenanalyse klicken, um direkt zur Seite Expl. Datenanalyse in Looker zu gelangen.

Felder in einem Explore filtern

Sie können die angezeigten Felder filtern, indem Sie Text in das Feld Felder in dieser explorativen Datenanalyse filtern eingeben. Die Eingabe wird dann mit dem Feldlabel oder der Beschreibung der Liste der Felder verglichen.

Sie können auch bestimmte Metadatenattribute zum Filtern auswählen, z. B. ob das Feld:

Feldmetadaten ansehen

Das Looker Data Dictionary zeigt die Metadaten für die Felder eines Explores gruppiert nach Ansicht an:

Angezeigte Metadaten anpassen

Sie können festlegen, welche Metadaten für jedes Feld angezeigt werden. Klicken Sie dazu oben rechts auf die Schaltfläche Ansichtsoptionen und setzen oder entfernen Sie ein Häkchen bei den Metadaten, die Sie sehen möchten.

Feldkommentare verwenden

Wenn eine Instanz bereits über Marketplace verfügt, sollten Administratoren sicherstellen, dass für die Data Dictionary-Erweiterung Version 2.0.0 oder höher installiert ist, damit Kommentare auf Feldebene verwendet werden können.

LookML-Entwickler fügen oft zusätzliche Informationen oder Erläuterungen zu den Feldern eines Modells in den Parameter description auf Feldebene ein. Diese Beschreibungen sind jedoch nicht immer für alle Nutzer sinnvoll oder nützlich. Mit Kommentaren auf Feldebene können Nutzer einem bestimmten Feld Kontext hinzufügen. Diese Kommentare sind für andere Nutzer sichtbar, haben aber keine Auswirkungen auf die zugrunde liegende LookML des Modells.

Administratoren müssen Nutzern die Möglichkeit geben, mit Kommentaren zu interagieren. Dazu fügen sie sie im Bereich Admin auf der Seite Gruppen bestimmten Gruppen hinzu. Standardmäßig können alle Nutzer mit Zugriff auf die Datenwörterbucherweiterung alle Kommentare ansehen und ihre eigenen Kommentare hinzufügen, bearbeiten und löschen.

Feldkommentar hinzufügen

So fügen Sie einem Feld einen Kommentar hinzu:

  1. Bewegen Sie den Mauszeiger auf die Feldzeile, um ein +-Symbol (wenn keine Feldkommentare vorhanden sind) oder ein Notizbuchsymbol (wenn für ein Feld Kommentare vorhanden sind) zu sehen. Klicken Sie auf das Symbol, um den Tab Kommentare im Bereich Feldprofiler zu öffnen.
  2. Klicken Sie auf die Schaltfläche Kommentar hinzufügen.
  3. Geben Sie Ihren Kommentar ein und klicken Sie auf die Schaltfläche Kommentar, um ihn zu speichern. Klicken Sie auf Abbrechen, um den Field Profiler zu schließen. Du kannst das Kommentarfeld maximieren, indem du es unten rechts auswählst und ziehst.

Nachdem ein Kommentar hinzugefügt wurde, wird er im Feld-Profiler auf dem Tab Kommentare angezeigt und ist für andere Nutzer sichtbar.

Feldkommentare ansehen

Wenn ein Feld Kommentare enthält, wird ein Notizbuchsymbol mit der Anzahl der Kommentare für dieses Feld angezeigt. Klicken Sie auf das Notizfeldsymbol, um die Kommentare des Felds anzuzeigen, die auf dem Tab Kommentare des Feldprofilers aufgeführt werden.

Die Anzahl der Kommentare zu diesem Feld wird auch auf dem Tab Kommentare in Klammern angezeigt. Jeder Kommentareintrag enthält folgende Informationen:

  • Name des Kommentators
  • Der Zeitstempel, der angibt, wann der Kommentar hinzugefügt wurde
  • Eine Vorschau des Kommentars

Feldkommentar bearbeiten oder löschen

So bearbeiten oder löschen Sie Ihre eigenen Feldkommentare:

  1. Klicken Sie auf das Notepad-Symbol des Felds.
  2. Suche auf dem Tab Kommentare den Kommentar, den du bearbeiten oder löschen möchtest, und bewege den Mauszeiger darauf.
  3. Klicke auf das Dreipunkt-Menü und wähle Kommentar bearbeiten aus, um den Kommentar zu bearbeiten, oder Kommentar löschen, um ihn zu löschen. Wenn Sie den Kommentar löschen möchten, bestätigen Sie Ihre Absicht.
  4. Wenn du deinen Kommentar bearbeitest, wähle Speichern aus, sobald du die gewünschten Änderungen vorgenommen hast.

Feldkommentar teilen

Die URL des Tabs Kommentare für jedes Feld ist eindeutig und kann kopiert und für andere Nutzer freigegeben werden, die im Looker Data Dictionary Zugriff auf dieses Modell haben.

Feldprofiler verwenden

Klicken Sie auf eine bestimmte Feldzeile, um den Feldprofiler zu öffnen. Dort werden alle Metadaten des Felds, Optionen für eine Vorschau numerischer Dimensionswerte und Schaltflächen zum Aufrufen der Looker IDE oder der Seite Explore angezeigt.

Wenn Sie Version 2.0.0 oder höher der Looker Data Dictionary-Erweiterung verwenden, wird der Feld-Profiler standardmäßig auf dem Tab Details geöffnet.

Wählen Sie im Bereich Verteilung die Option Berechnen aus, um eine Vorschau eines Säulendiagramms mit der Verteilung der Zählwerte für numerische Dimensionen in einer Ansicht mit einem Messwert mit type: count aufzurufen. Im Bereich Verteilung werden auch die Mindest-, Höchst- und Durchschnittswerte der numerischen Dimensionsreihen angezeigt.

Wählen Sie unter Werte die Option Berechnen aus, um eine Vorschau der Zählwerte für numerische Dimensionen in einer Ansicht mit einem Messwert mit type: count zu sehen. Klicken Sie auf die Schaltfläche Mehr entdecken, um die Benutzeroberfläche für explorative Datenanalysen mit der numerischen Dimension und dem Zählungsmesswert zu öffnen, die in der Feldauswahl vorausgewählt wurden.

Wählen Sie Zu LookML aus, um die Ansichtsdatei aus dem LookML-Projekt zu öffnen, das mit dem ausgewählten Modell in der Looker-IDE verknüpft ist.

Klicken Sie auf die Schaltfläche Mit Feld untersuchen, um die Seite Erkunden zu öffnen. Das Feld wird dabei automatisch aus dem Field Picker ausgewählt.