LookML-Diagramm verwenden

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

Das LookML-Diagramm ist ein Entitäts-Beziehungsdiagramm eines LookML-Modells, das die Beziehungen zwischen seinen LookML-Objekten visuell darstellt. Mit dieser Erweiterung können Sie:

  • Bewerten Sie die Struktur des LookML-Modells, identifizieren Sie Bereiche, in denen LookML konsolidiert werden kann, und Bestimmen Sie, wie das Modell am besten ergänzt werden kann.
  • Falsche Logik identifizieren, um die Wahrscheinlichkeit von fehlerhaften Berechnungen und Abfrageleistung zu verringern
  • Informationen zur codebasierten Datenmodellierung (LookML)

Auf dieser Dokumentationsseite wird die Verwendung des LookML-Diagramms in der Version 2.0.0 und höher beschrieben. Looker-Administratoren finden Informationen zum Aktivieren dieser Erweiterung für Looker-Nutzer auf der Dokumentationsseite LookML Diagram-Erweiterung konfigurieren.

Auf dieser Seite wird erläutert, wie Sie:

Nachdem das LookML-Diagramm installiert wurde, können Sie zum LookML-Diagramm navigieren, indem Sie im linken Navigationsbereich auf Blöcke klicken und dann die Kachel LookML-Diagramm auswählen.

LookML-Objektbeziehungen mit dem LookML-Diagramm beobachten

Ihr Looker-Administrator muss Ihnen Berechtigungen für das lookml_diagram-Modell und jedes Modell gewähren, das Sie in der Erweiterung anzeigen möchten.

Die LookML-Diagrammerweiterung besteht aus folgenden Elementen:

  1. Im Bereich Diagrammeinstellungen können Sie ein model, einen Git-Zweig und ein Explore auswählen.
  2. Das Feld View Options (Ansichtsoptionen) zum Eingrenzen der Felder, die angezeigt werden sollen
  3. Einen Abschnitt zur Diagrammhilfe mit zusätzlichen Erläuterungen zu den Diagrammelementen
  4. Ein Diagramm-Canvas zur Interaktion mit den LookML-Objekten im ausgewählten Explore
  5. Die Liste der Felder eines ausgewählten Explores, gruppiert nach Ansicht
  6. Eine Symbolleiste mit Zoom- und Positionsoptionen sowie ein Symbol zum Ein- oder Ausblenden der Canvas-Minimap, mit der Sie sich in einem größeren Diagramm besser orientieren können
  7. Einen Objekt-Profiler, um Informationen zum LookML-Objekt anzusehen und gegebenenfalls zum zugehörigen LookML- oder Explore-Objekt zu wechseln

Doppelklicken Sie auf das Symbol Diagrammeinstellungen oder das Symbol Ansichtsoptionen, um den linken Bereich zu minimieren.

Diagrammeinstellungen konfigurieren

Klicken Sie in der Navigationsleiste des Diagramms auf das Diagrammsymbol, um die Diagrammeinstellungen aufzurufen.

Im Drop-down-Menü Modell auswählen werden alle Modelle aufgelistet, für die Sie Berechtigungen zum Ansehen haben. Sobald Sie ein Modell ausgewählt haben, werden zwei zusätzliche Optionen angezeigt:

  • Das Drop-down-Menü Aktueller Zweig wird mit einer Liste der Git-Zweige dieses Modells gefüllt. Wenn das Modell nur einen Zweig hat – normalerweise den Produktionszweig – wird dieser Zweig angezeigt. Wenn Sie sich im Produktionsmodus befinden oder keine Berechtigungen zum Ändern von Git-Zweigen haben, ist das Drop-down-Menü Aktueller Zweig deaktiviert.

    Wenn Ihr Administrator Ihnen Berechtigungen zum Ändern von Git-Zweigen im LookML-Diagramm erteilt hat, aktivieren Sie den Entwicklungsmodus. Stellen Sie sicher, dass sowohl ein Modell als auch ein Explore ausgewählt sind, und wählen Sie dann einen Zweig aus, um das Diagramm entsprechend der Einrichtung des Modells für diesen Zweig anzusehen.

  • Die Liste Explore auswählen wird mit einer Liste der Explores dieses Modells gefüllt. Klicken Sie auf den Namen eines Explores, um seine Felder nach Ansicht gruppiert auf dem Seitencanvas anzuzeigen.

Anzeigeoptionen ansehen

Wenn ein Explore ausgewählt ist, können Sie im Bereich Ansichtsoptionen festlegen, welche Felder und Ansichten im Canvas angezeigt werden.

Angezeigte Felder begrenzen

Sie können in jeder Ansicht des Explores alle Felder anzeigen lassen. Wählen Sie dazu unter Anzuzeigende Felder die Option Alle Felder aus. Um nur die Ansichten anzuzeigen, in denen Felder mit anderen Feldern verbunden sind, wählen Sie Felder mit Joins aus.

Wenn diese Option aktiviert ist, blendet die Ein-/Aus-Schaltfläche Ausgeblendete Felder ausblenden alle Felder aus, die in der zugrunde liegenden LookML hidden: yes enthalten. Die Ein-/Aus-Schaltfläche Ausgeblendete Felder ausblenden ist standardmäßig aktiviert.

Angezeigte Ansichten begrenzen

Der Abschnitt Ansichten des Felds Ansichtsoptionen enthält eine Liste der Ansichten im ausgewählten Explore. Standardmäßig werden alle Ansichten auf dem Diagrammcanvas angezeigt. Wenn Sie eine Ansicht ausblenden, werden das Ansichtsobjekt und alle Joins, die dieses Ansichtsobjekt mit anderen Objekten im Explore verbinden, auf dem Diagrammcanvas ausgeblendet.

Klicken Sie auf Alle ausblenden, um alle Ansichten im Explore auf dem Diagrammcanvas auszublenden. Klicken Sie auf Alle anzeigen, um alle Ansichten in diesem Explore einzublenden.

Sie können auch einzelne Ansichten im Canvas ausblenden, indem Sie die Auswahl des Augensymbols rechts neben dem Ansichtsnamen aufheben. Wenn die Ansicht ausgeblendet ist, erscheint der Name der Ansicht ausgegraut und das Augensymbol ist durchgestrichen. Um eine einzelne ausgeblendete Ansicht wieder einzublenden, klicken Sie auf das Symbol mit dem geschrägten Auge.

Diagrammcanvas interpretieren

Im LookML-Diagramm-Canvas werden alle Entitäten und Beziehungen für ein bestimmtes Explore dargestellt. In der Looker-Sprache können Sie sich das LookML-Diagramm so vorstellen, dass LookML-Objekte in einem Explore für ein bestimmtes Modell verbunden werden.

In der Objekttitelleiste oben im Canvas wird der Name des Explores angezeigt, dessen Ansichten auf dem Canvas angezeigt werden. Klicken Sie in der Titelleiste des Objekts auf das Symbol „Explore-Info“ – ein eingekreistes „i“ –, um den Objekt-Profiler zu öffnen und mehr über das ausgewählte Explore zu erfahren. Klicken Sie auf den Pfeil im Uhrzeigersinn, um die Erweiterung neu zu laden.

Entitäten

Jede Ansicht des Explores wird als eigenes Entitäts-Set dargestellt, wobei der Ansichtsname am Anfang des Satzes angezeigt wird:

  1. Die Basisansicht des Explores wird durch einen dunkelblauen Hintergrund gekennzeichnet.
  2. Verbundene Ansichten im explorativen Analysetool haben einen hellblauen Hintergrund.

  3. Wenn ein Join, eine Ansicht oder ein Feld ausgewählt wird, wird dieser leuchtend blau hervorgehoben.

    Unter jeder Ansicht finden Sie eine Liste der Felder, die zu dieser Ansicht gehören:

  4. Die Abmessungen sind oben aufgeführt.

  5. Die Messungen sind unten aufgeführt und hellorange hervorgehoben.

  6. Wenn das Feld ein Primärschlüssel ist, wird rechts neben dem Feldnamen ein Schlüsselsymbol angezeigt.

Links neben jedem Feld befindet sich ein Symbol, das den Typ angibt:

  • A: Dimensionen von type: string
  • # Dimensionen oder Kennzahlen von type: number
  • Gestaffelte Balken: Abmessungen von type: tier
  • Häkchen: Abmessungen von type: yesno
  • Kalender: Dimensionen von type: date, type: date_time, type: time
  • Kartenpunkt: Abmessungen von type: location, type: distance und type: zipcode

Klicken Sie auf den Feldnamen, um den Objekt-Profiler zu öffnen und mehr über das ausgewählte Feld zu erfahren.

Beziehungen

Im Diagramm wird anhand einer Linie dargestellt, in welcher Beziehung jedes Objekt zu einem anderen Objekt im ausgewählten Modell steht. Die Form der Linie, an der sie mit der Ansicht oder dem Feld verbunden ist, gibt die Kardinalität der Beziehung zwischen den beiden Objekten wieder. Eine verzweigte Linie steht für eine Kardinalität von „viele“ und eine einzelne Linie für eine Kardinalität von „Eine“. Die Beziehung lässt sich so lesen: von der Basisansicht zur verbundenen Ansicht. Beispiel:

  1. Ein 1:1-Join von order_items zu inventory_items, bei dem im Feld id zusammengeführt wird
  2. 1:1-Join von order_items bis repeat_purchase_facts

Sie können auch den Mauszeiger auf die Linie bewegen, um zu sehen, mit welcher Art der Join-Beziehung die beiden Objekte verbunden werden.

Klicken Sie auf die Linie, um den Objekt-Profiler zu öffnen und weitere Informationen zum Join zu sehen.

Optionen für die Leinwand-Ansicht

Eine Minimap oben rechts im Canvas kann Ihnen bei der Orientierung in größeren Diagrammen helfen. Der ausgegraute Teil der Karte gibt an, welcher Teil des Diagramms gerade auf dem Canvas angezeigt wird. Klicken Sie auf den leeren Bereich im Canvas und ziehen Sie ihn, um zu anderen Teilen des Diagramms zu wechseln.

Eine vertikale Symbolleiste unten links im Canvas enthält Symbole zur Steuerung der Diagrammanzeige:

  • Klicken Sie auf (+), um das Diagramm zu vergrößern, und auf (-), um herauszuzoomen.
  • Klicken Sie auf das quadratische Symbol, um zur standardmäßigen Startposition des Diagramms zurückzukehren.
  • Klicken Sie auf das Kartensymbol, um die Minimap zu aktivieren oder zu deaktivieren.

Objektinformationen mit dem Objekt-Profiler ansehen

Der Objekt-Profiler zeigt Informationen zum ausgewählten Objekt an. Klicken Sie im Diagramm-Canvas auf ein Explore, eine Ansicht, ein Feld oder einen Join, um den Objekt-Profiler auf der rechten Seite des Canvas zu öffnen. Klicken Sie auf den Canvas, um den Objekt Profiler zu minimieren.

Explores

Klicken Sie auf das Symbol „Explore-Info“ – ein einkreisendes „i“ – auf der rechten Seite der Objekttitelleiste.

Für das im Bereich Diagrammeinstellungen ausgewählte Explore wird der Object Profiler angezeigt:

  • Label: Der Wert von Explore label.
  • Gruppenlabel: Der Wert des Parameters group_label, mit dem Explores im Menü Explore von Looker zu benutzerdefinierten Gruppen zusammengefasst werden. Wenn für das Explore keine Gruppenbezeichnung definiert ist, wird standardmäßig der Name des Modells verwendet.
  • Projektname: Der Name des LookML-Projekts, wie in den Projekteinstellungen festgelegt.
  • Connection Name (Verbindungsname): Der Wert des Parameters connection, der die Datenbankverbindung angibt, von der ein Modell Daten abruft.

Wenn Sie Berechtigungen zum Aufrufen von LookML haben, können Sie links unten im Objekt-Profiler auf Zu LookML wechseln klicken, um die Datei zu öffnen, in der das Explore definiert ist. Die Datei wird in einem neuen Browsertab geöffnet und die Zeile für explore ist markiert.

Ansichten

Klicken Sie im Diagrammcanvas auf eine Ansicht.

Der Object Profiler zeigt den SQL-Tabellennamen an, wenn er im LookML der Ansicht definiert ist. Wenn kein sql_table_name für die Ansicht definiert ist, wird der Name der SQL-Tabelle als unknown angezeigt.

Wenn Sie Berechtigungen zum Aufrufen von LookML haben, können Sie links unten im Objekt-Profiler auf Zu LookML wechseln klicken, um die Datei zu öffnen, in der das Explore definiert ist, mit dem die Ansicht verknüpft ist. Die Datei wird in einem neuen Browsertab geöffnet und die Zeile für explore ist markiert.

Felder

Klicken Sie im Diagrammcanvas auf ein Feld.

Oben im Steuerfeld wird im Objekt-Profiler der Feldname, der Typ und der Typwert angezeigt. Außerdem wird oben im Steuerfeld angegeben, ob das Feld ein Primärschlüssel ist. Zwei Tabs im Profiler – Details und Code – enthalten zusätzliche Informationen über das Feld.

Auf dem Tab Details sehen Sie Folgendes:

  • Name der Datenansicht: Der Name der Ansicht, zu der das Feld gehört.
  • Beschriftung: So wird das Feld im Abschnitt „Daten“ eines Explores angezeigt. Dies ist der Name oder Label der Ansicht, gefolgt vom Namen oder Label des Felds.
  • Verteilung: Klicken Sie bei numerischen Dimensionen in einer Ansicht mit einem Messwert mit type: count auf Berechnen. Daraufhin wird eine Vorschau eines Säulendiagramms angezeigt, in dem die Verteilung der Anzahlwerte dargestellt ist. Im Abschnitt Verteilung werden außerdem die Mindest-, Höchst- und Durchschnittswerte der numerischen Dimensionsreihen angezeigt.
  • Werte: Klicken Sie bei numerischen Dimensionen in einer Ansicht mit einer Messung mit type: count auf Berechnen, um eine Vorschau der Anzahlwerte aufzurufen. Klicken Sie auf Mehr ansehen, um das Explore zu öffnen, zu dem dieses Feld gehört.

Auf dem Tab Code werden Feldparameter und Unterparameter angezeigt.

Wenn Sie Berechtigungen zum Aufrufen von LookML haben, können Sie links unten im Objekt-Profiler auf Zu LookML wechseln klicken, um die Datei zu öffnen, in der der Join definiert wurde. Die Datei wird in einem neuen Browsertab in der Zeile für das Explore des Joins geöffnet.

Wenn Sie Berechtigungen zum Entdecken von Daten haben, klicken Sie rechts unten im Objekt-Profiler auf Mit Feld untersuchen, um ein Explore zu öffnen, bei dem das Feld in der Feldauswahl für Explores vorausgewählt ist.

Joins

Klicken Sie im Diagramm-Canvas auf einen Join.

Der Object Profiler zeigt die Join-Anweisung an, in der die Join-Beziehung sowie Typ und Kardinalität des Joins beschrieben werden.

Wenn Sie Berechtigungen zum Aufrufen von LookML haben, können Sie links unten im Objekt-Profiler auf Zu LookML wechseln klicken, um die Datei zu öffnen, in der der Join definiert wurde. Die Datei wird in einem neuen Browsertab in der Zeile für das Explore des Joins geöffnet.