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 und mit dem Looker-Erweiterungs-Framework entwickelt und über den Looker Marketplace bereitgestellt wird.

Die Looker Data Dictionary-Erweiterung bietet eine dedizierte, zentrale Oberfläche für die Suche in allen Looker-Feldern und ‐Beschreibungen. 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. * Erleichtern Sie es externen Stakeholdern, eindeutige Metriken zu identifizieren und zu finden. * Prüfen Sie LookML-Modelle, um festzustellen, ob konsistente Namenskonventionen eingehalten werden, ob es redundante Felder gibt oder ob Felder mit Beschreibungen annotiert 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 Benutzer auf das Looker Data Dictionary 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. Gewähren Sie Berechtigungen für den Zugriff auf das 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. Rufen Sie die Metadaten Ihres Modells auf.

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)

Für die Installation von Anwendungen und Tools, z. B. Erweiterungen, aus dem Marketplace sind die Berechtigungen develop, manage_models und deploy erforderlich.

In der Dokumentation Looker Marketplace verwenden finden Sie eine Anleitung zur Installation eines Tools aus dem Looker Marketplace. Damit Sie immer die neueste Version des Data Dictionary verwenden, rufen Sie 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

Nach der Installation des Looker Data Dictionary wird ein Modell namens data-dictionary automatisch zur Liste der verfügbaren Modelle auf den Seiten Neuer Modellsatz und Modellsatz bearbeiten hinzugefügt. Sie 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 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 festlegen, 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 User-Gruppen müssen mit den vordefinierten Namen erstellt werden, die in der folgenden Tabelle in der Spalte Gruppenname angezeigt werden. In der Tabelle sind auch die vordefinierten Berechtigungen aufgeführt, die die einzelnen Gruppen zugewiesenen Nutzer haben.

Gruppenname Berechtigungen
marketplace_data_dictionary_comments_disabled Nutzer können Kommentare nicht sehen oder auf andere Weise damit interagieren. Die Kommentarfunktion ist deaktiviert. Die Berechtigungen dieser Gruppe haben immer Vorrang vor denen anderer Gruppen. Nutzer in der Gruppe "disabled" haben keinen Zugriff auf die Kommentarfunktion, selbst wenn sie einer anderen Gruppe mit umfassenderen 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 ansehen, neue Kommentare hinzufügen und alle Kommentare bearbeiten oder löschen.

Wenn ein Nutzer zu keiner dieser Gruppen gehört, wird er standardmäßig auf writer gesetzt. 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 Data Dictionary ü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. Das Looker Data Dictionary zeigt die Explores des ausgewählten Modells in der linken Seitenleiste und die Ansichten und Felder des ausgewählten Explores im Hauptteil der Seite an.

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 jedem Feld. Wählen Sie mit der Schaltfläche Ansichtsoptionen aus, welche Metadaten angezeigt werden sollen. Den gesamten Metadatensatz des Felds finden Sie im Feld-Profiler.
  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 das ausgewählte Modell auch nach einem bestimmten Explore durchsuchen, 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 die Felder, gruppiert nach Ansicht, im Hauptteil der Seite anzuzeigen.

Sie können auch oben rechts auf die Schaltfläche Explore klicken, 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 Filter fields in this Explore (Felder in diesem Explore filtern) eingeben, um sie mit der Liste der Felder abzugleichen. Feldbezeichnung oder Beschreibung:

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

Feldmetadaten aufrufen

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, indem Sie die Schaltfläche View Options (Ansichtsoptionen) oben rechts auswählen und die Kästchen für die Metadaten aktivieren oder deaktivieren, die Sie ansehen 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 aussagekräftig oder für alle Nutzenden hilfreich. Mithilfe von Kommentaren auf Feldebene können Nutzer einem bestimmten Feld Kontext hinzufügen. Diese Kommentare sind für andere Benutzer sichtbar, haben aber keine Auswirkungen auf den zugrunde liegenden LookML-Code 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. Wenn Sie den Mauszeiger auf die Feldzeile bewegen, erscheint ein +-Symbol (wenn keine Feldkommentare vorhanden sind) oder ein Notizblocksymbol (wenn ein Feld bereits Kommentare enthält). Klicken Sie auf das Symbol, um den Tab Kommentare im Feld-Profiler-Bereich 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 Ihren Eintrag zu speichern. Klicken Sie auf Abbrechen, um den Field Profiler zu schließen. Sie können das Kommentarfeld erweitern, indem Sie die rechte untere Ecke auswählen und ziehen.

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 Notizblocksymbol mit der Anzahl der Kommentare in diesem 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 für dieses Feld wird auch auf dem Tab Kommentare in Klammern angezeigt. Jeder Kommentareintrag enthält die folgenden Informationen:

  • Name des Kommentators
  • 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. 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. 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 Sie den Kommentar löschen möchten, bestätigen Sie Ihre Absicht.
  4. Wenn Sie Ihren Kommentar bearbeiten, wählen Sie Speichern aus, nachdem Sie die Änderungen vorgenommen haben.

Feldkommentar freigeben

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.

Feld-Profiler verwenden

Klicken Sie auf eine bestimmte Feldzeile, um einen Feldprofiler-Bereich zu öffnen, in dem alle Metadaten des Felds, Optionen zur Vorschau numerischer Dimensionswerte und Schaltflächen zum Aufrufen der Looker-IDE oder der Seite Explore angezeigt werden.

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 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 einem Messwert mit type: count darstellt. 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 Anzahl der Werte für numerische Dimensionen in einer Ansicht mit einem Messwert mit type: count aufzurufen. Klicken Sie auf die Schaltfläche Mehr entdecken, um die Benutzeroberfläche des explorativen Analysetools zu öffnen. Die numerische Dimension und der Messwert für die Anzahl sind im Field Picker bereits ausgewählt.

Wählen Sie Zu LookML wechseln 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.