Diagramm: LookML-Diagramm verwenden

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

Das LookML-Diagramm ist ein Entitäts-Beziehungs-Diagramm eines LookML-Modells, das die Beziehungen zwischen den LookML-Objekten visuell darstellt. Diese Erweiterung bietet folgende Möglichkeiten:

  • Struktur des LookML-Modells bewerten, Bereiche identifizieren, in denen LookML konsolidiert werden kann, und bestimmen, wie sich das Modell am besten ergänzen lässt
  • Fehlerhafte Logik ermitteln und so die Wahrscheinlichkeit von falschen Berechnungen und schlechter Abfrageleistung verringern
  • Codebasierte (LookML) Datenmodellierung ausführen

Auf dieser Dokumentationsseite wird beschrieben, wie Sie die LookML-Diagrammversion 2.0.0 und höher verwenden. Looker-Administratoren finden auf der Dokumentationsseite LookML-Diagrammerweiterung konfigurieren eine Anleitung dazu, wie diese Erweiterung für Looker-Nutzer aktiviert wird.

Auf dieser Seite wird Folgendes erläutert:

Nachdem das LookML-Diagramm installiert wurde, können Sie zum LookML-Diagramm wechseln, 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 Modell lookml_diagram und jedes Modell gewähren, das Sie in der Erweiterung aufrufen möchten.

Die Erweiterung des LookML-Diagramms besteht aus folgenden Elementen:

  1. Im Bereich Diagrammeinstellungen können Sie ein Modell, einen Git-Zweig und einen Entdecken auswählen.
  2. Im Bereich Ansichtsoptionen können Sie festlegen, welche Felder angezeigt werden sollen.
  3. Einen Abschnitt in der Diagrammhilfe zur zusätzlichen Erläuterung der Diagrammelemente
  4. Ein Canvas, auf dem mit den LookML-Objekten in der ausgewählten Tabelle „Erkunden“ interagiert werden kann
  5. Eine ausgewählte Liste mit Feldern zum Erkunden, gruppiert nach Ansicht
  6. Eine Symbolleiste mit Zoom- und Positionsoptionen und einem Symbol zum Ein- oder Ausblenden der Canvas-Minimap. Das hilft Ihnen dabei, sich in einem größeren Diagramm zu orientieren.
  7. Einen Object Profiler, um Informationen zum LookML-Objekt aufzurufen und gegebenenfalls die zugehörige LookML- oder Explore-Funktion aufzurufen

Klicken Sie doppelt auf das Symbol Diagrammeinstellungen oder auf 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.

Über das Drop-down-Menü Modell auswählen werden alle Modelle aufgelistet, für die Sie Berechtigungen sehen können. Nachdem Sie ein Modell ausgewählt haben, werden zwei zusätzliche Optionen angezeigt:

  • Das Drop-down-Menü Current Branchfüllt sich mit einer Liste der Git-Zweige dieses Modells. Wenn das Modell nur einen Zweig hat – in der Regel der 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 gewährt hat, aktivieren Sie den Entwicklungsmodus. Achten Sie darauf, dass sowohl ein Modell als auch ein Erkunden ausgewählt sind. Wählen Sie dann einen Zweig aus, um das Diagramm entsprechend der Einrichtung des Modells in diesem Zweig aufzurufen.

  • Die Liste Erkunden wird mit einer Liste der Erkundungen dieses Modells gefüllt. Klicken Sie auf den Namen einer explorativen Datenanalyse, um die nach Ansicht gruppierten Felder im Canvas aufzurufen.

Optionen zum Ansehen

Wenn Sie „Erkunden“ ausgewählt haben, können Sie im Steuerfeld Ansichtsoptionen festlegen, welche Felder und Ansichten auf dem Canvas angezeigt werden sollen.

Angezeigte Felder beschränken

Sie können auswählen, ob alle Felder in jeder Ansicht des Bereichs „Erkunden“ angezeigt werden sollen. Wählen Sie dazu unter Anzuzeigende Felder die Option Alle Felder aus. Sie können auch Felder mit Joins auswählen, damit nur die Ansichten mit verknüpften Feldern angezeigt werden.

Wenn die Option Ausgeblendete Felder ausblenden aktiviert ist, werden alle Felder ausgeblendet, die im zugrunde liegenden LookML hidden: yes enthalten. Die Ein-/Aus-Schaltfläche Ausgeblendete Felder ausblenden ist standardmäßig aktiviert.

Angezeigte Ansichten begrenzen

Im Bereich Ansichten des Bereichs Ansichtsoptionen finden Sie eine Liste der Ansichten, die im ausgewählten Bereich verfügbar sind. Standardmäßig werden alle Ansichten im Diagramm-Canvas angezeigt. Wenn Sie eine Ansicht ausblenden, werden das Ansichtsobjekt und alle Joins, die dieses Ansichtsobjekt mit anderen Objekten der Umgebung verbinden, im Diagramm-Canvas ausgeblendet.

Klicken Sie auf Alle ausblenden, um alle Ansichten in der Ansicht „Erkunden“ im Diagramm-Canvas auszublenden. Klicken Sie auf Alle anzeigen, um alle Datenansichten in dieser Umgebung einzublenden.

Sie können auch einzelne Ansichten im Canvas ausblenden, indem Sie das Augensymbol rechts neben dem Namen der Ansicht entfernen. Wenn die Ansicht ausgeblendet ist, wird der Name ausgegraut und das Augensymbol ist durchgestrichen. Wenn Sie eine einzelne ausgeblendete Ansicht wieder einblenden möchten, klicken Sie auf das Augensymbol.

Interpretation des Diagramm-Canvas

Im LookML-Diagramm-Canvas werden alle Entitäten und Beziehungen für eine bestimmte Erkundung angezeigt. Bei der Looker-Verzweigung können Sie sich das LookML-Diagramm ansehen. Es veranschaulicht, wie LookML-Objekte in einem Explore für ein bestimmtes Modell verknüpft werden.

Die Objekttitelleiste am oberen Rand des Canvas zeigt den Namen des explorativen Analysetools an, dessen Ansichten auf dem Canvas angezeigt werden. Klicken Sie in der Objekttitelleiste auf das runde Symbol – eingekreist ", um den Objekt Profiler zu öffnen und mehr über die ausgewählte Funktion zu erfahren. Klicken Sie auf den Pfeil im Uhrzeigersinn, um die Erweiterung zu aktualisieren.

Entitäten

Jede Ansicht der Ansicht wird als eigener Entitäts-Set dargestellt, wobei der Ansichtsname oben angezeigt wird:

  1. Die Basisansicht wird durch einen dunkelblauen Hintergrund dargestellt.
  2. Zusammengeführte Ansichten im Bereich „Erkunden“ haben einen hellblauen Hintergrund.
  3. Wenn Sie einen Join, eine Ansicht oder ein Feld auswählen, wird er hellblau hervorgehoben.

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

  4. Die Dimensionen sind oben aufgeführt.

  5. Die Messwerte sind unten aufgeführt und hellorange markiert.

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

Links neben jedem Feld wird ein Symbol angezeigt, das den Typ angibt:

  • A: Abmessungen von type: string
  • #: Dimensionen oder Maße von type: number
  • Abgestufte Balken: Abmessungen von type: tier
  • Häkchen: Abmessungen von type: yesno
  • Kalender: Abmessungen von type: date, type: date_time, type: time
  • Kartenpunkt: Abmessungen von type: location, type: distance, 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 eine Linie verwendet, um darzustellen, wie jedes Objekt mit einem anderen Objekt im ausgewählten Modell in Beziehung steht. Die Form der Linie, die mit der Ansicht oder dem Feld verbunden ist, vermittelt die Kardinalität der Beziehung zwischen den beiden Objekten. Eine verzweigte Linie gibt eine Kardinalität und eine einzelne Linie eine „Eins“-Kardinalität an. In diesem Fall würden Sie die Beziehung von der Basisansicht zur verknüpften Ansicht lesen. Beispiel:

  1. Eins-zu-Eins-Join von order_items bei inventory_items über das Feld id
  2. Ein 1:1-Join von order_items bis repeat_purchase_facts

Wenn Sie den Mauszeiger auf die Linie bewegen, sehen Sie, welche Join-Beziehung zwischen den beiden Objekten besteht.

Klicken Sie auf die Zeile, um den Object Profiler zu öffnen und weitere Informationen zum Join aufzurufen.

Canvas-Ansichtsoptionen

Mit einer Minikarte rechts oben auf dem Canvas können Sie Ihr Placement in größeren Diagrammen ausrichten. Der ausgegraute Teil der Karte gibt an, welcher Teil des Diagramms derzeit auf dem Canvas angezeigt wird. Klicken Sie auf den leeren Bereich des Arbeitsbereichs und ziehen Sie ihn, um zu anderen Teilen des Diagramms zu wechseln.

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

  • Klicken Sie auf das Pluszeichen (+), um das Diagramm zu vergrößern, oder auf das Minuszeichen (-), um das Diagramm zu verkleinern.
  • Klicken Sie auf das quadratische Symbol, um zur Standardstartposition des Diagramms zurückzukehren.
  • Klicken Sie auf das Kartensymbol, um die Minikarte 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 einen beliebigen Erkundungs-, Aufruf- oder Join-Bereich, um den Objekt-Profiler auf der rechten Seite des Canvas zu öffnen. Klicken Sie auf den Canvas, um den Object Profiler zu minimieren.

Explores

Klicken Sie rechts neben der Objekttitelleiste auf das Symbol „Informationen ansehen“ – eingekreist &i&t.

Für den im Bereich Diagrammeinstellungen ausgewählten Erkundenbereich zeigt der Objektprofiler Folgendes an:

  • Label: Der Wert von label auswerten.
  • Gruppenlabel: Der Wert des Parameters group_label. Er kombiniert „Entdecken“ im Looker-Menü Durchsuchen zu benutzerdefinierten Gruppen. Wenn für „Erkunden“ kein Gruppenlabel definiert ist, wird standardmäßig der Name des Modells verwendet.
  • Projektname: Der Name des LookML-Projekts, wie er in den Projekteinstellungen festgelegt ist.
  • Connection Name (Verbindungsname): Der Wert des Parameters connection. Dieser gibt die Datenbankverbindung an, von der ein Modell Daten abruft.

Wenn Sie die Berechtigung zum Ansehen von LookML haben, können Sie links unten im Objekt-Profiler auf Go LookLook klicken, um die Datei zu öffnen, in der die Funktion „Erkunden“ definiert ist. Die Datei wird in einem neuen Browsertab geöffnet. Die Zeile für explore ist markiert.

Aufrufe

Klicken Sie im Diagramm-Canvas auf eine Ansicht.

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

Wenn Sie die Berechtigung zum Ansehen von LookML haben, können Sie links unten im Objekt-Profiler auf Go LookML klicken, um die Datei zu öffnen, mit der die Ansicht verknüpft wird, mit der die Ansicht verknüpft wird. Die Datei wird in einem neuen Browsertab geöffnet. Die Zeile für explore ist markiert.

Felder

Klicken Sie auf ein Feld im Diagramm-Canvas.

Objekt Profiler zeigt den Feldnamen, den Typ und den Typwert an und ob das Feld ein Primärschlüssel ist. Im Tab „Profiler“ – Details und Code – finden Sie zusätzliche Informationen zum Feld.

Auf dem Tab Details sehen Sie Folgendes:

  • Name der Datenansicht: Der Name der Ansicht, zu der das Feld gehört.
  • Label: Gibt an, wie das Feld im Bereich „Daten“ einer explorativen Datenanalyse angezeigt werden soll. Das sind der Name oder das Label der Ansicht gefolgt vom Namen oder Label des Felds.
  • Verteilung: Bei numerischen Dimensionen in einer Ansicht mit einem Messwert mit type: count klicken Sie auf Berechnen. Daraufhin wird eine Vorschau eines Säulendiagramms mit der Verteilung der Zählwerte angezeigt. Im Bereich Verteilung werden auch die Mindest-, Höchst- und Durchschnittswerte der numerischen Dimensionsreihen angezeigt.
  • Werte: Für numerische Dimensionen in einer Datenansicht mit einem Messwert, der type: count hat, klicken Sie auf Berechnen, um eine Vorschau der Zählwerte anzuzeigen. Klicken Sie auf Mehr entdecken, um das Feld „Erkunden“ zu öffnen, zu dem dieses Feld gehört.

Auf dem Tab Code sehen Sie den Feldparameter und die Unterparameter.

Wenn Sie die Berechtigung zum Ansehen von LookML haben, können Sie links unten im Objektprofil auf Zu LookML klicken, um die Datei zu öffnen, in der der Join definiert wird. Die Datei wird in einem neuen Browsertab in der Zeile der Join-Ansicht geöffnet.

Wenn Sie die Berechtigungen zum Erkunden von Daten haben, klicken Sie rechts unten im Objektprofil auf Mit Feld untersuchen. Daraufhin wird in der Feldauswahl für „Erkunden“ ein vorausgefülltes Feld mit der Bezeichnung „Erkunden“ geöffnet.

Joins

Klicken Sie im Diagramm-Canvas auf einen Join.

Im Objekt- Profiler wird die Join-Anweisung angezeigt, die die Join-Beziehung sowie den Typ und die Kardinalität des Joins beschreibt.

Wenn Sie die Berechtigung zum Ansehen von LookML haben, können Sie links unten im Objektprofil auf Zu LookML klicken, um die Datei zu öffnen, in der der Join definiert wird. Die Datei wird in einem neuen Browsertab in der Zeile der Join-Ansicht geöffnet.