LookML-Dashboards erstellen

LookML-Dashboards werden von LookML-Entwicklern erstellt und als versionsgesteuerte Dateien gespeichert. Standardmäßig werden sie im Ordner LookML-Dashboards Ihrer Looker-Instanz angezeigt.

Informationen zum Vergleichen und Vergleichen von LookML-Dashboards und benutzerdefinierten Dashboards finden Sie auf der Dokumentationsseite Benutzerdefinierte und LookML-Dashboards vergleichen.

Zum Erstellen eines LookML-Dashboards benötigen Sie die folgenden Looker-Berechtigungen:

Darüber hinaus müssen Sie Zugriff auf die LookML-Modelle für alle Daten haben, die Sie im Dashboard verwenden möchten.

LookML-Dashboard-Datei erstellen

Um ein LookML-Dashboard zu erstellen, erstellen Sie zuerst eine Dashboarddatei mit der Erweiterung .dashboard.lookml. Der .lookml-Teil der Erweiterung ist in der IDE jedoch still. Dazu sind folgende Schritte erforderlich:

  1. Aktivieren Sie den Entwicklermodus.
  2. Rufen Sie im Menü Develop Ihr Projekt auf.
  3. Klicken Sie in der Looker-IDE oben im Dateibrowserbereich auf das Pluszeichen Datei oder Ordner hinzufügen, um eine LookML-Dashboard-Datei außerhalb vorhandener Projektordner zu erstellen. Sie können auch auf das Dreipunkt-Menü Ordneroptionen eines Ordners klicken, um die Datei im Ordner zu erstellen. Klicken Sie auf Dashboard erstellen, um die Dashboarddatei zu erstellen.

  1. Das Fenster Datei erstellen wird angezeigt. Geben Sie innerhalb des Fensters im Feld für die Eingabe einen Namen für die Dashboarddatei ein und klicken Sie auf die Schaltfläche Erstellen.

LookML-Dashboard-Dateien bearbeiten

Wenn Sie eine LookML-Dashboard-Datei erstellen, füllt Looker die Datei vorab mit mehreren grundlegenden Dashboard-Parametern, die Einstellungen für das gesamte Dashboard implementieren. Außerdem füllt es die Datei vorab mit mehreren beispielhaften Dashboard-Elementparametern, die unter dem Dashboard-Parameter elements gruppiert sind und die Funktion und Darstellung von Dashboard-Tiles, ‐Text und ‐Schaltflächen definieren. Eine neu erstellte .dashboard.lookml-Datei enthält ein Dashboard-LookML ähnlich dem folgenden:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Sie können die Dashboard-Datei in der IDE bearbeiten, solange Sie sich im Entwicklungsmodus befinden.

Sie haben mehrere Möglichkeiten, Ihr Dashboard zu erstellen:

  • Manuelle Erstellung: Sie können ein Dashboard manuell mithilfe von Dashboard-Parametern und Dashboard-Elementparametern erstellen.
  • Benutzerdefiniertes Dashboard kopieren: Sie können eine Kopie eines benutzerdefinierten Dashboards erstellen, indem Sie den vorab ausgefüllten LookML-Code für das Dashboard aus der Datei löschen, den LookML-Code für das Dashboard aus einem benutzerdefinierten Dashboard kopieren und ihn in Ihre Dashboarddatei einfügen.
  • Dashboard-LookML von Elementen kopieren: Sie können den LookML-Code für das Dashboard aus einem Explore oder einem Look kopieren und in Ihre Dashboarddatei einfügen.

Beachten Sie beim Erstellen eines Dashboards die Best Practices für die Dashboard-Konstruktion. Informationen und Empfehlungen zum Erstellen leistungsstarker Dashboards finden Sie auf der Seite mit den Best Practices unter Überlegungen beim Erstellen leistungsstarker Looker-Dashboards.

Visualisierung zu einem vorhandenen LookML-Dashboard hinzufügen

Am einfachsten können Sie einem vorhandenen LookML-Dashboard eine Visualisierung hinzufügen, indem Sie auf der Explore-Seite eine Abfrage erstellen, die Sie in ein Dashboard-Element umwandeln möchten:

  1. Nachdem Sie die Abfrage und Visualisierung erstellt haben, die Sie zu einem Dashboard hinzufügen möchten, klicken Sie auf das Zahnrad-Menü Explore-Aktionen des Explores.
  2. Wählen Sie LookML abrufen aus, um den LookML-Code verfügbar zu machen.

  3. Das Fenster LookML abrufen wird angezeigt. Wählen Sie im Fenster Dashboard aus, wählen Sie den gesamten LookML-Code aus und kopieren Sie ihn.

    Oben im Fenster „LookML abrufen“ befinden sich die Registerkarten „Dashboard“, „Aggregate Table“ und „Abgeleitete Tabelle“.

Fügen Sie den LookML-Code dann in die LookML-Datei Ihres Dashboards ein. Achten Sie beim Bearbeiten der LookML-Datei des Dashboards auf Folgendes:

  • Achten Sie darauf, dass Sie sich im Entwicklermodus befinden, damit Sie die Dashboard-Datei bearbeiten können.
  • Fügen Sie den LookML-Code unter dem Parameter elements des Dashboards ein.
  • Verwenden Sie beim Einfügen von LookML in die Dashboarddatei den korrekten Einzug. Gleichen Sie den Einzug nach Möglichkeit mit vorhandenen Elementen aus, die bereits in der Dashboard-Datei vorhanden sind.

Sie können die LookML-Parameter bei Bedarf mithilfe der Parameter anpassen, die auf den Dokumentationsseiten für jeden einzelnen Elementtyp beschrieben werden.

Fügen Sie Filter hinzu

Sobald Sie Dashboard-Elemente in Ihrer Dashboard-Datei gespeichert haben, können Sie Filter hinzufügen, mit denen Dashboard-Betrachter einige oder alle Elemente in einem Dashboard filtern können. Filter können aus vielen möglichen Gründen nützlich sein, zum Beispiel:

  • Angezeigten Zeitraum anpassen
  • Die Anzeige von Produktkategorien, Kundentypen usw. anpassen
  • Bereitstellung einer Suchfunktion für einen Kunden oder Kunden

Achten Sie darauf, den gewünschten Filtertyp zu erstellen. Es gibt zwei Arten:

  • Filter, die Sie in die Dashboard-Elemente hartcodieren und die Dashboard-Betrachter nicht ändern können
  • Dashboard-Filter, die Betrachter von Dashboards ändern können

In Dashboard-Elemente fest codierte Filter

Filter, die Sie in den Dashboard-Elementen fest codieren und die Benutzer nicht ändern können, werden normalerweise automatisch im Schritt zum Kopieren von LookML für eine Visualisierung oder für ein Dashboard erstellt. In einem LookML-Dashboard verwenden diese Filter den Dashboardelementparameter filters und sehen so aus:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Dashboard-Filter

Mit Dashboard-Filtern können Betrachter die in Dashboard-Elementen angezeigten Daten interaktiv optimieren. So erstellen Sie einen Dashboard-Filter:

  1. Erstellen Sie den Dashboard-Filter mithilfe des Parameters filters in Ihrer LookML-Dashboarddatei.
  2. Wenden Sie den Filter mithilfe des Parameters listen auf einzelne Dashboardelemente an.

Dashboard-Filter erstellen

Mit dem Parameter filters können Sie verschiedene Arten von interaktiven Filtern für Ihr Dashboard erstellen.

Fügen Sie der Dashboarddatei einen filters-Parameter hinzu, um einen Dashboard-Filter zu erstellen, mit dem Nutzer interagieren können. Mit dem folgenden Beispielcode wird beispielsweise ein LookML-Dashboard mit den Filtern date und category_name erstellt:

- dashboard: dashboard_name
  title: Dashboard Title
  layout: newspaper
  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

Mit dem Code im vorherigen Beispiel werden die folgenden Filter erstellt:

  • date: Ein Datumsfilter, mit dem Nutzer einen Zeitraum auswählen können. Der Standardwert ist auf die letzten 30 Tage festgelegt.
  • category_name: Ein Feldfilter, mit dem Nutzer nach Produktkategorie filtern können. Dieser Filter generiert dynamisch Optionen, die auf dem Feld category.name im angegebenen LookML-Modell (ecommerce) und Explore (product) basieren.

Dashboard-Filter auf Dashboard-Elemente anwenden

Nachdem Sie einen Dashboard-Filter erstellt haben, können Sie ihn mithilfe des Parameters listen auf einzelne Dashboard-Elemente anwenden. Wenn Sie den Parameter listen auf diese Weise verwenden, können die verknüpften Elemente basierend auf der Auswahl des Nutzers im Filter dynamisch aktualisiert werden.

Sehen Sie sich beispielsweise den folgenden LookML-Beispielcode für ein Flächendiagramm-Element an:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'

Im Diagramm „approved_orders_by_day“ wird die Anzahl der genehmigten Aufträge pro Tag angezeigt, da die Abfrage auf der Dimension „orders_created_date“ und dem Messwert „orders.count“ basiert und den Filter „orders.status: 'approved'“ angewendet hat. Dieser Filter ist im Element unveränderlich und kann von Dashboard-Betrachtern nicht geändert werden.

Damit Nutzer das Diagramm approved_orders_by_day mit den Filtern date und category_name aus dem vorherigen Beispiel filtern können, fügen Sie dem Dashboard-Element den Parameter listen hinzu.

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'
  listen:
    category_name: category.name
    date: orders.created_date

Wenn ein Dashboard-Betrachter mit dem Filter category_name oder date interagiert, wird das Diagramm „approved_orders_by_day“ automatisch mit den gefilterten Ergebnissen aktualisiert.

Der Parameter listen verwendet die Syntax filter_name: field_name. Im vorherigen Beispiel sind category_name und date die Namen der Filter. category.name und orders.created_date sind die Felder, mit denen Dashboard-Betrachter Eingaben für den Filter vornehmen können.

Ein Dashboard-Filter kann auf jedes Feld desselben Datentyps in einem beliebigen Element angewendet werden. Beispielsweise kann ein Element die Eingabe eines Nutzers auf das Erstellungsdatum der Bestellung (date: orders.created_date) und ein anderes auf das Versanddatum der Bestellung (date: orders.ship_date) anwenden:

- name: element_one
  # lots of other element parameters here
  listen:
    date: orders.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: orders.ship_date

Dashboarddatei in ein Modell einbinden

Damit Ihr Dashboard für die Vorschau im Entwicklungsmodus oder in der Produktion sichtbar ist, muss es mithilfe einer include-Anweisung in die Modelldatei aufgenommen werden, auf der das Dashboard basiert.

Eine gängige Praxis besteht darin, alle LookML-Dashboards mithilfe eines Platzhalters in ein Modell aufzunehmen:

include: "*.dashboard.lookml"

Wenn Ihre LookML-Dashboards in einem Ordner in der IDE angezeigt werden, verwenden Sie den Pfad zum Speicherort

 include: "/path/*.dashboard.lookml"

Sie können auch ein bestimmtes Dashboard einschließen, indem Sie seinen Dateinamen angeben:

include: "my_dashboard.dashboard.lookml"

LookML-Dashboard speichern, in der Vorschau anzeigen und veröffentlichen

So rufen Sie eine Vorschau des Dashboards auf:

  1. Speichern Sie die Datei .dashboard.lookml, indem Sie rechts oben in der Datei auf die Schaltfläche Änderungen speichern klicken.
  2. Fügen Sie das Dashboard in die entsprechende Modelldatei ein und speichern Sie die Änderungen an dieser Datei.
  3. Klicken Sie in der Datei .dashboard.lookml, für die Sie sich eine Vorschau ansehen möchten, auf den Abwärtspfeil Dateiaktionen ansehen und wählen Sie Dashboard ansehen aus.

Sie können weitere Änderungen an der Datei „.dashboard.lookml“ vornehmen, sie speichern und das Dashboard noch einmal als Vorschau ansehen.

Wenn Sie mit Ihrem Dashboard zufrieden sind, können Sie es als Produktionsversion veröffentlichen, sodass andere Nutzer mit den entsprechenden Berechtigungen es sehen können. Die Methode zum Veröffentlichen des Dashboards entspricht der Veröffentlichung anderer Änderungen an LookML auf Ihrer Instanz und hängt von den Einstellungen zur Versionsverwaltung für Ihre Looker-Instanz ab.

LookML-Dashboard-Ordner

Nach der Veröffentlichung werden LookML-Dashboards standardmäßig im Ordner LookML-Dashboards gespeichert. Der Ordner LookML-Dashboards befindet sich im Ordner Ordner im linken Navigationsbereich. Der Ordner LookML-Dashboards unterscheidet sich in einigen Punkten von anderen Ordnern:

  • Sie müssen in mindestens eine Modelldatei ein LookML-Dashboard einfügen, damit es im Ordner LookML-Dashboards angezeigt wird.
  • Damit Nutzer den Ordner LookML-Dashboards sehen können, müssen sie die Berechtigung see_lookml_dashboards haben.
  • Um Dashboards im Ordner LookML-Dashboards zu sehen, müssen Nutzer Zugriff auf das LookML-Modell haben, das das Dashboard enthält.
  • Um eine bestimmte Kachel in einem LookML-Dashboard zu sehen, müssen Dashboard-Betrachter Zugriff auf das LookML-Modell haben, auf dem die Kachel basiert.
  • Um ein Dashboard im Ordner LookML-Dashboards zu bearbeiten, benötigen Sie die Berechtigung develop für das Modell, das das LookML-Dashboard enthält.
  • Um eine Kachel innerhalb eines Dashboards vom Typ Von hier aus erkunden, müssen Dashboard-Betrachter die Berechtigung explore für das Modell haben, auf dem diese Kachel basiert.
  • Sie können keinen Ordner im Ordner LookML-Dashboards erstellen.

LookML-Dashboards aus dem Ordner für LookML-Dashboards verschieben

Wenn Sie die Looker-Berechtigungen see_lookml_dashboards und develop sowie Zugriff auf das LookML-Modell haben, in dem ein LookML-Dashboard enthalten ist, können Sie ein LookML-Dashboard in jeden Ordner verschieben, für den Sie die Ordnerzugriffsebene Zugriff verwalten, bearbeiten haben.

Es gibt zwei Möglichkeiten, das Dashboard zu verschieben:

  • Wählen Sie im Ordner LookML-Dashboards das zu verschiebende Dashboard aus, klicken Sie oben im Abschnitt „Dashboards“ auf die Schaltfläche Verschieben und wählen Sie den Ordner aus, in den Sie das Dashboard verschieben möchten. Weitere Informationen finden Sie auf der Dokumentationsseite Inhalte organisieren und verwalten.
  • Klicken Sie im Ordner LookML-Dashboards auf das Dreipunkt-Menü des Dashboards, wählen Sie im Menü Verschieben und dann den Ordner aus, in den Sie das Dashboard verschieben möchten.

Im Entwicklungsmodus können Sie LookML-Dashboards nicht aus dem Ordner LookML-Dashboards verschieben. Sie können stattdessen die Option Importieren verwenden, um das LookML-Dashboard als benutzerdefiniertes Dashboard in einen anderen Ordner zu kopieren.

In einem Ordner, der sowohl benutzerdefinierte Dashboards als auch LookML-Dashboards enthält, werden die LookML-Dashboards im Abschnitt LookML-Dashboard angezeigt. Im Abschnitt LookML-Dashboard können Sie ein LookML-Dashboard in einen anderen Ordner verschieben oder ein LookML-Dashboard an ein Board anpinnen. Im Gegensatz zu benutzerdefinierten Dashboards können LookML-Dashboards jedoch nicht umbenannt oder aus einem Ordner in den Papierkorb verschoben werden.

Wenn der Wert des Parameters dashboard eines LookML-Dashboards geändert wird, wird das LookML-Dashboard automatisch zurück in den Ordner LookML-Dashboards verschoben.

LookML für ein vorhandenes LookML-Dashboard anzeigen

Wenn Sie die Berechtigung see_lookml haben, können Sie zum Dashboard-LookML für ein vorhandenes LookML-Dashboard navigieren. Wählen Sie dazu Go to LookML (Zu LookML wechseln) aus dem Dreipunkt-Menü Dashboard-Aktionen eines Dashboards aus:

Wenn Sie Zu LookML wechseln, navigiert Looker zur Dashboarddatei, in der das LookML-Dashboard definiert ist.

LookML-Dashboard erweitern

Nachdem Sie ein LookML-Dashboard erstellt haben, können Sie das Dashboard erweitern. Auf diese Weise können Sie auf der Grundlage des ursprünglichen Dashboards ein zweites Dashboard erstellen und dabei möglicherweise einige Einstellungen hinzufügen oder überschreiben. Wenn Sie dann das erste Dashboard ändern, werden diese Änderungen automatisch für das zweite Dashboard übernommen, sofern die Änderungen im zweiten Dashboard nicht überschrieben werden. Weitere Informationen finden Sie auf der Dokumentationsseite Code mit erweiterten Erweiterungen wiederverwenden.

Dashboard-Leistung mit Aggregatfunktion verbessern

LookML-Entwickler können möglicherweise die Leistung des LookML-Dashboards verbessern, indem sie Aggregate Awareness verwenden. Mit Aggregatfunktion können Entwickler aggregierte Tabellen unter LookML-explore-Parametern erstellen, wodurch Abfragen für eine oder mehrere Tiles in einem Dashboard optimiert werden können.

Nachdem Sie ein LookML-Dashboard erstellt haben und es sich ansehen, können Sie im Dreipunkt-Menü Dashboard-Aktionen die Option Get Aggregated Table LookML verwenden. Diese Option ist sichtbar, wenn Sie die Berechtigung see_lookml haben.

Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter aggregate_table.