Looker Data Dictionary verwenden

Looker Data Dictionary unterscheidet sich vom Data Dictionary-Block.

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

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

Die Looker Data Dictionary-Erweiterung bietet eine dedizierte, zentrale Oberfläche zum Durchsuchen aller Looker-Felder und -Beschreibungen. Mit dieser Erweiterung können Sie:

  • Stellen Sie ein durchsuchbares Verzeichnis für alle Messwerte und Beschreibungen bereit, damit Nutzer die passende Dimension oder Kennzahl für die Analyse identifizieren können
  • Erleichtern Sie externen Stakeholdern die Identifizierung und Lokalisierung eindeutiger Metriken.
  • Prüfen Sie LookML-Modelle, um zu beurteilen, ob einheitliche Namenskonventionen eingehalten werden, ob es redundante Felder gibt oder Felder mit Beschreibungen annotiert sind
  • Kommentare zu bestimmten Feldern hinzufügen und teilen (wenn Ihre Looker Data Dictionary-Anwendung Version 2.0.0 oder höher ist)

Damit Nutzer auf das Looker Data Dictionary zugreifen und es verwenden können, müssen Looker-Administratoren Folgendes tun:

  1. Aktivieren Sie die entsprechenden Funktionen.
  2. Installieren Sie die Looker Data Dictionary-Erweiterung.
  3. Gewähren Sie Berechtigungen für den Zugriff auf Looker Data Dictionary.

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

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

Looker Data Dictionary installieren

Bevor Sie das Looker Data Dictionary aus dem Marketplace installieren, müssen Looker-Administratoren diese Funktionen aktivieren:

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

Für die Installation von Anwendungen und Tools wie Erweiterungen aus dem Marketplace benötigen Sie die Berechtigungen develop, manage_models und deploy.

Eine Anleitung zum Installieren eines Tools aus dem Looker Marketplace finden Sie in der Dokumentation Looker Marketplace verwenden. Damit Sie immer über die neueste Version des Data Dictionary verfügen, rufen Sie den Looker Marketplace auf, wählen Sie Verwalten und dann die Schaltfläche Aktualisieren neben der Erweiterung aus.

Berechtigungen für den Zugriff auf Looker Data Dictionary gewähren

Nach der Installation von Looker Data Dictionary wird ein Modell namens data-dictionary automatisch zur Liste der verfügbaren Modelle auf den Seiten New Model Set und Edit Model Set hinzugefügt. Diese können im Bereich Admin über die Seite Rollen aufgerufen werden.

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 zum Gewähren von Berechtigungen für den Zugriff auf und die Verwendung von Erweiterungen finden Sie auf der Dokumentationsseite Berechtigungen für Looker-Erweiterungen festlegen.

Berechtigungen zum Interagieren mit Feldkommentaren gewähren

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

Looker-Administratoren können bei Bedarf verwalten, wie Nutzer mit der Funktion zum Kommentieren von Feldern interagieren. Dazu erstellen sie im Bereich Admin 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 Gruppen.

Looker-Administratoren müssen diese Gruppen mit den vordefinierten Namen erstellen, wie unten dargestellt.

Die Nutzergruppen müssen mit den vordefinierten Namen aus der Tabelle unten erstellt werden. Die Tabelle enthält auch die vordefinierten Berechtigungen, die Nutzer der einzelnen Gruppen haben.

Gruppenname Berechtigungen
marketplace_data_dictionary_comments_disabled Nutzer können Kommentare nicht sehen und auch nicht anderweitig damit interagieren. Sämtliche Kommentarfunktionen sind deaktiviert. Die Berechtigungen dieser Gruppe haben immer Vorrang vor denen anderer Gruppen. Jeder in der Gruppe disabled hat keinen Zugriff auf die Kommentarfunktion, selbst wenn er einer anderen Gruppe angehört, die umfassendere Berechtigungen hat.
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 sehen, neue Kommentare hinzufügen und ihre eigenen 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/löschen.

Wenn ein Nutzer keiner dieser Gruppen angehört, wird er standardmäßig auf writer gesetzt. Wenn ein Nutzer mehreren Gruppen zugewiesen ist (ohne marketplace_data_dictionary_comments_disabled), hat dessen umfassendere Berechtigung Vorrang.

Änderungen an einer Kommentargruppe, z. B. das Hinzufügen oder Entfernen eines Nutzers, die über die Seite Gruppen im Admin-Bereich vorgenommen werden, werden nach einer vollständigen Aktualisierung der Data Dictionary-Seite wirksam, oder wenn der Nutzer eine andere Option auswählt und dann zur Data Dictionary-Seite zurückkehrt.

Sie können Data Dictionary aus der 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 model auswählen und seine Metadaten ansehen, einschließlich der Explores und der Liste 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:

  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 jedem Feld. Über die Schaltfläche Ansichtsoptionen können Sie festlegen, welche Metadaten angezeigt werden sollen. Den gesamten Metadatensatz des Feldes im Feld-Profiler ansehen
  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

Im Drop-down-Menü Modell auswählen werden alle Modelle aufgelistet, für die ein Nutzer die Berechtigung explore hat. Wenn Sie ein Modell aus dem Drop-down-Menü Modell auswählen auswählen, wird in der linken Seitenleiste eine Liste der Explores dieses Modells angezeigt.

Sie können im ausgewählten Modell auch nach einem bestimmten Explore suchen, indem Sie etwas in das Suchfeld Modell suchen 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 dessen Felder gruppiert nach Ansicht im Hauptteil der Seite anzuzeigen.

Sie können auch die Schaltfläche Explore (Erkunden) oben rechts auswählen, um direkt die Seite Explore in Looker aufzurufen.

Felder in einem Explore filtern

Sie können die angezeigten Felder filtern, indem Sie Text in das Feld Filterfelder in diesem Explore eingeben, um ihn mit der Feldbezeichnung oder der Beschreibung der Felder abzugleichen.

Sie können auch bestimmte Metadatenattribute auswählen, nach denen gefiltert werden soll, 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 aktivieren oder deaktivieren Sie die Kontrollkästchen für die gewünschten Metadaten.

Feldkommentare verwenden

Wenn eine Instanz bereits den Marketplace hat, sollten Administratoren sicherstellen, dass die Data Dictionary-Erweiterung Version 2.0.0 oder höher ist, um Kommentare auf Feldebene zu verwenden.

LookML-Entwickler fügen häufig zusätzliche Informationen oder Erläuterungen zu den Feldern eines Modells in den Parameter description auf Feldebene ein. Diese Beschreibungen sind jedoch nicht immer aussagekräftig oder hilfreich. Mit Kommentaren auf Feldebene können Nutzer einem bestimmten Feld Kontext hinzufügen. Diese Kommentare sind für andere Benutzer sichtbar, sie wirken sich aber nicht auf das zugrunde liegende LookML des Modells aus.

Administratoren müssen Nutzern erlauben, mit Kommentaren zu interagieren. Dazu fügen sie sie im Steuerfeld Verwaltung auf der Seite Gruppen bestimmten Gruppen hinzu. Standardmäßig können alle Nutzer mit Zugriff auf die Datenwörterbuch-Erweiterung alle Kommentare sehen und eigene 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 Notizblocksymbol (wenn ein Feld Kommentare enthält) einzublenden. Klicken Sie auf das Symbol, um den Tab Kommentare des Feld-Profilers zu öffnen.
  2. Klicken Sie auf die Schaltfläche Kommentar hinzufügen.
  3. Geben Sie Ihren Kommentar ein und wählen Sie die Schaltfläche Kommentieren aus, um den Eintrag zu speichern. Klicken Sie auf Abbrechen, um den Feld-Profiler zu schließen. Sie können das Kommentarfeld maximieren, indem Sie die untere rechte Ecke auswählen und ziehen.

Sobald ein Kommentar hinzugefügt wurde, wird er auf dem Tab Kommentare des Feld-Profilers angezeigt und ist für andere Nutzer einsehbar.

Feldkommentare ansehen

Wenn ein Feld Kommentare enthält, wird ein Symbol für den Notizblock mit der Anzahl der vorhandenen Kommentare für das Feld angezeigt. Klicken Sie auf das Notizblock-Symbol, um die Kommentare des Felds auf dem Tab Kommentare des Feld-Profilers anzusehen.

Die Anzahl der Kommentare in diesem Feld wird auch auf dem Tab Kommentare in Klammern angezeigt. Jeder Kommentar enthält die folgenden Informationen:

  • Name der Person, die das Dokument kommentiert hat
  • Der Zeitstempel, der angibt, wann der Kommentar hinzugefügt wurde
  • Vorschau des Kommentars

Feldkommentar bearbeiten oder löschen

So bearbeiten oder löschen Sie Ihre eigenen Feldkommentare:

  1. Wählen Sie das Notizblock-Symbol des Felds aus.
  2. Suche auf dem Tab Kommentare den Mauszeiger auf den Kommentar, den du bearbeiten oder löschen möchtest.
  3. Klicken Sie auf das Dreipunkt-Menü und wählen Sie Kommentar bearbeiten aus, um den Kommentar zu bearbeiten, oder Kommentar löschen, um ihn zu löschen. Wenn du den Kommentar löschen möchtest, musst du bestätigen, dass du das möchtest.
  4. Wenn Sie Ihren Kommentar bearbeiten, wählen Sie Speichern aus, nachdem Sie die Änderungen vorgenommen haben.

Feldkommentar teilen

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

Feld-Profiler verwenden

Wenn Sie auf eine bestimmte Feldzeile klicken, wird rechts auf der Seite ein Feld-Profiler-Bereich mit allen Metadaten des Felds, Optionen für die Vorschau numerischer Dimensionswerte und Schaltflächen geöffnet, über die Sie zur Looker-IDE oder zur Seite Explore wechseln können.

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

Wählen Sie im Abschnitt Verteilung die Option Berechnen aus, um eine Vorschau eines Säulendiagramms aufzurufen, das die Verteilung der Anzahlwerte für numerische Dimensionen in einer Ansicht mit einer Messung zeigt, für die type: count festgelegt ist. Im Bereich Verteilung werden außerdem die Mindest-, Höchst- und Durchschnittswerte der numerischen Dimensionsreihen angezeigt.

Wählen Sie unter Werte die Option Berechnen aus, um eine Vorschau der Anzahlwerte für numerische Dimensionen in einer Ansicht mit einer Messung mit type: count aufzurufen. Klicken Sie auf die Schaltfläche Explore More (Mehr anzeigen), um die Explore-Benutzeroberfläche zu öffnen. Die numerische Dimension und die Anzahl der Messwerte sind bereits im Field Picker ausgewählt.

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, auf der das Feld automatisch aus dem Field Picker ausgewählt wurde.