LookML-Dashboards erstellen

LookML-Dashboards werden von LookML-Entwicklern erstellt und als versionierte 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:

Außerdem benötigen Sie Zugriff auf die LookML-Modelle für alle Daten, die Sie im Dashboard verwenden möchten.

LookML-Dashboarddatei 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. Gehen Sie dazu so vor:

  1. Aktivieren Sie den Entwicklungsmodus.
  2. Rufen Sie im Menü Entwickeln Ihr Projekt auf.
  3. Wählen Sie in der Looker-IDE oben im Dateibrowserbereich das Pluszeichen für Datei oder Ordner hinzufügen aus, um eine LookML-Dashboard-Datei außerhalb vorhandener Projektordner zu erstellen. Alternativ können Sie 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 im Fenster im Eingabefeld einen Namen für die Dashboarddatei ein und klicken Sie auf die Schaltfläche Erstellen.

LookML-Dashboarddateien 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 werden in der Datei mehrere Beispielparameter für Dashboard-Elemente vorab eingefügt. Diese sind unter dem Dashboard-Parameter elements gruppiert und definieren die Funktion und das Aussehen von Dashboard-Kacheln, Text und Schaltflächen. 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, ein Dashboard zu erstellen:

  • Manuelles Erstellen: Sie können ein Dashboard manuell mithilfe von Dashboard- und Dashboardelement-Parametern erstellen.
  • Benutzerdefiniertes Dashboard kopieren: Sie können eine Kopie eines benutzerdefinierten Dashboards erstellen, indem Sie die vorab ausgefüllte Dashboard-LookML aus der Datei löschen, die Dashboard-LookML aus einem benutzerdefinierten Dashboard kopieren und in Ihre Dashboarddatei einfügen.
  • LookML-Code für Dashboardelemente kopieren: Sie können die LookML für das Dashboard aus einem Explore oder einem Look kopieren und in die 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 Best Practices Hinweise zum Erstellen leistungsstarker Looker-Dashboards.

Visualisierung zu einem vorhandenen LookML-Dashboard hinzufügen

Am einfachsten fügen Sie einem vorhandenen LookML-Dashboard eine Visualisierung hinzu, 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 einem Dashboard hinzufügen möchten, klicken Sie auf das Zahnradsymbol Explore-Aktionen.
  2. Wählen Sie LookML abrufen aus, um die LookML zu sehen.

  3. Das Fenster LookML abrufen wird angezeigt. Wählen Sie im Fenster Dashboard aus und kopieren Sie die gesamte LookML.

    Oben im Fenster „LookML abrufen“ finden Sie die Tabs „Dashboard“, „Aggregierte Tabelle“ und „LookML für 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:

  • Prüfen Sie, ob Sie sich im Entwicklungsmodus befinden, damit Sie die Dashboard-Datei bearbeiten können.
  • Fügen Sie den LookML-Code unter dem Parameter elements des Dashboards ein.
  • Achten Sie beim Einfügen von LookML in die Dashboarddatei auf die richtige Einrückung. 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 nach Bedarf anpassen. Verwenden Sie dazu die Parameter, die auf den Dokumentationsseiten für die einzelnen Elementtypen beschrieben sind.

Fügen Sie Filter hinzu

Nachdem 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 Gründen nützlich sein, z. B.:

  • Angezeigten Zeitraum anpassen
  • Anpassung der angezeigten Produktkategorie, des Kundentyps usw.
  • Bereitstellung einer Funktion vom Typ „Suche“ für einen 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 von Dashboard-Besuchern geändert werden können

In Dashboard-Elemente fest codierte Filter

Filter, die Sie in die Dashboard-Elemente hartcodieren und die Nutzer nicht ändern können, werden in der Regel automatisch beim Kopieren der 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 fixiert und kann von Dashboard-Besuchern 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 von Filtern und category.name und orders.created_date die Felder, über die Dashboard-Betrachter Eingaben für den Filter vornehmen können.

Ein Dashboard-Filter kann auf beliebige Felder (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 aufnehmen

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 den 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 auf die Schaltfläche Änderungen speichern klicken.
  2. Fügen Sie das Dashboard in die entsprechende Modelldatei ein und speichern Sie die Änderungen in 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 .dashboard.lookml-Datei vornehmen, sie speichern und sich eine Vorschau des Dashboards ansehen.

Wenn Sie mit Ihrem Dashboard zufrieden sind, können Sie es in der Produktion veröffentlichen. So können andere Nutzer mit den richtigen Berechtigungen es sehen. Die Veröffentlichung des Dashboards erfolgt auf die gleiche Weise wie die Veröffentlichung anderer Änderungen an der LookML in Ihrer Instanz. Sie hängt von den Einstellungen für die Versionskontrolle Ihrer 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 einer 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.
  • Damit Nutzer Dashboards im Ordner LookML-Dashboards sehen können, benötigen sie Zugriff auf das LookML-Modell, 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.
  • Wenn Sie ein Dashboard im Ordner LookML-Dashboards bearbeiten möchten, 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.
  • Im Ordner LookML-Dashboards können Sie keinen Ordner erstellen.

LookML-Dashboards außerhalb des Ordners „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 Bereich „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 Seite Inhalte organisieren und verwalten.
  • Klicken Sie im Ordner LookML-Dashboards auf das Dreipunkt-Menü für das Dashboard, wählen Sie Verschieben aus dem Menü aus und wählen Sie den Ordner aus, in den Sie das Dashboard verschieben möchten.

Wenn Sie sich im Entwicklungsmodus befinden, können Sie LookML-Dashboards nicht außerhalb des Ordners 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 Bereich LookML-Dashboard können Sie ein LookML-Dashboard in einen anderen Ordner verschieben oder 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 wieder in den Ordner LookML-Dashboards verschoben.

LookML für ein vorhandenes LookML-Dashboard anzeigen

Wenn Sie die Berechtigung see_lookml haben, können Sie die LookML für ein vorhandenes LookML-Dashboard aufrufen. Wählen Sie dazu im Dreipunkt-Menü Dashboard-Aktionen die Option Zu LookML aus:

Wenn Sie Zu LookML wechseln auswählen, öffnet Looker die Dashboard-Datei, in der das LookML-Dashboard definiert ist.

LookML-Dashboard erweitern

Nachdem Sie ein LookML-Dashboard erstellt haben, können Sie es erweitern. So können Sie ein zweites Dashboard auf Grundlage des ursprünglichen erstellen und gegebenenfalls 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 „extends“ wiederverwenden.

Dashboard-Leistung mit Aggregatfunktion verbessern

LookML-Entwickler können eventuell die Leistung von LookML-Dashboards mit der Aggregatfunktion verbessern. 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 aggregierte Tabelle LookML verwenden. Diese Option ist sichtbar, wenn Sie die Berechtigung see_lookml haben.

Weitere Informationen finden Sie auf der Seite mit der Parameterdokumentation zu aggregate_table.