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 Gegenüberstellen von LookML-Dashboards und benutzerdefinierten Dashboards finden Sie auf der Dokumentationsseite Vergleich von benutzerdefinierten und LookML-Dashboards.

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

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

LookML-Dashboarddatei erstellen

Um ein LookML-Dashboard zu erstellen, beginnen Sie mit dem Erstellen einer Dashboard-Datei mit der Erweiterung .dashboard.lookml. Der Teil .lookml der Erweiterung wird in der IDE nicht angezeigt. So gehen Sie vor:

  1. Aktivieren Sie den Entwicklermodus.
  2. Rufen Sie im Menü Entwickeln Ihr Projekt auf.
  3. Wählen Sie oben im Dateibrowserbereich in der Looker-IDE das Pluszeichen Datei oder Ordner hinzufügen aus, um eine LookML-Dashboarddatei außerhalb der vorhandenen 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 Eingabefeld einen Namen für die Dashboarddatei ein und wählen Sie die Schaltfläche Erstellen aus.

LookML-Dashboarddateien bearbeiten

Wenn Sie eine LookML-Dashboarddatei erstellen, füllt Looker die Datei mit mehreren grundlegenden Dashboardparametern vor, die Einstellungen für das gesamte Dashboard implementieren. Außerdem werden in der Datei mehrere Beispielparameter für Dashboard-Elemente vorab ausgefüllt, die unter dem elements Dashboardparameter gruppiert sind und die Funktion und das Erscheinungsbild von Dashboard-Kacheln, Text und Schaltflächen definieren. Eine neu erstellte .dashboard.lookml-Datei enthält LookML-Code für das Dashboard, der so aussieht:

- 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 mit Dashboardparametern und Parametern für Dashboard-Elemente 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 in Ihre Dashboarddatei einfügen.
  • LookML-Code für Dashboardelemente 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 Best Practices-Seite Überlegungen beim Erstellen leistungsstarker Looker-Dashboards.

Visualisierung zu einem vorhandenen LookML-Dashboard hinzufügen

Die einfachste Möglichkeit, einem vorhandenen LookML-Dashboard eine Visualisierung hinzuzufügen, besteht darin, auf der Seite „Explore“ eine Abfrage zu 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 Zahnradmenü Explore-Aktionen des Explore.
  2. Wählen Sie LookML abrufen aus, um den LookML-Code anzuzeigen.

  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“ gibt es Tabs für Dashboard-, aggregierte Tabellen- und abgeleitete Tabellen-LookML.

Fügen Sie den LookML-Code hier in Ihre LookML-Datei für das Dashboard ein. Beachten Sie beim Bearbeiten der LookML-Datei für das Dashboard Folgendes:

  • Prüfen Sie, ob Sie sich im Entwicklermodus befinden, damit Sie die Dashboarddatei bearbeiten können.
  • Fügen Sie den LookML-Code unter dem Parameter elements des Dashboards ein.
  • Verwenden Sie beim Einfügen von LookML-Code in die Dashboarddatei die richtige Einrückung. Richten Sie die Einrückung nach Möglichkeit an vorhandenen Elementen aus, die sich bereits in der Dashboarddatei befinden.

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.

Filter hinzufügen

Nachdem Sie Dashboardelemente in Ihrer Dashboarddatei gespeichert haben, können Sie Filter hinzufügen, mit denen Dashboardbetrachter einige oder alle Elemente in einem Dashboard filtern können. Filter können aus vielen Gründen nützlich sein, z. B.:

  • Zeitraum anpassen
  • Bestimmte Produktkategorie, Kundentyp usw. anpassen
  • Suchfunktion für einen Kunden oder Klienten bereitstellen

Erstellen Sie den gewünschten Filtertyp. Es gibt zwei Arten:

  • Filter, die Sie fest in die Dashboardelemente codieren und die von Dashboardbetrachtern nicht geändert werden können
  • Dashboardfilter, die von Dashboardbetrachtern geändert werden können

Filter, die fest in Dashboardelemente codiert sind

Filter, die Sie fest in die Dashboardelemente codieren und die von Nutzern nicht geändert werden können, werden normalerweise automatisch im Schritt „LookML kopieren“ für eine Visualisierung oder für ein Dashboard erstellt. In einem LookML-Dashboard verwenden diese Filter den filters Parameter für Dashboardelemente und sehen so aus:

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

Dashboard-Filter

Mit Dashboardfiltern können Betrachter die in Dashboardelementen angezeigten Daten interaktiv eingrenzen. So erstellen Sie einen Dashboardfilter:

  1. Erstellen Sie den Dashboardfilter mit dem filters Parameter in Ihrer LookML-Dashboarddatei.
  2. Wenden Sie den Filter mit dem listen Parameter auf einzelne Dashboardelemente an.

Dashboardfilter erstellen

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

Wenn Sie einen Dashboardfilter erstellen möchten, mit dem Nutzer interagieren können, fügen Sie Ihrer Dashboarddatei einen Parameter filters hinzu. 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

Der Code im vorherigen Beispiel erstellt die folgenden Filter:

  • 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.

Dashboardfilter auf Dashboardelemente anwenden

Nachdem Sie einen Dashboardfilter erstellt haben, können Sie ihn mit dem Parameter listen auf einzelne Dashboardelemente anwenden. Wenn Sie den Parameter listen auf diese Weise verwenden, können die verknüpften Elemente dynamisch anhand der Auswahl des Nutzers im Filter aktualisiert werden.

Betrachten Sie beispielsweise den folgenden LookML-Beispielcode für ein Flächendiagrammelement:

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

Das approved_orders_by_day Diagramm zeigt die Anzahl der genehmigten Bestellungen pro Tag, da die Abfrage auf der orders_created_date Dimension und dem orders.count Messwert basiert und ein Filter angewendet wurde: orders.status: 'approved'. Dieser Filter ist im Element festgelegt und kann von Dashboardbetrachtern nicht geändert werden.

Wenn Nutzer das approved_orders_by_day Diagramm mit dem date Filter und dem category_name Filter aus dem vorherigen Beispiel filtern sollen, fügen Sie den listen Parameter dem Dashboard-Element 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 Dashboardbetrachter mit dem Filter category_name oder dem Filter date interagiert, wird das Diagramm approved_orders_by_day automatisch aktualisiert, um die gefilterten Ergebnisse widerzuspiegeln.

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

Ein Dashboardfilter kann auf jedes Feld (mit demselben Datentyp) in einem beliebigen Element angewendet werden. In einem Element kann die Eingabe eines Nutzers beispielsweise auf das Erstellungsdatum der Bestellung angewendet werden (date: orders.created_date), während sie in einem anderen auf das Versanddatum der Bestellung angewendet wird (date: orders.ship_date):

- 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

Dashboard-Datei in ein Modell einbeziehen

Damit Ihr Dashboard im Entwicklermodus in der Vorschau oder in der Produktion sichtbar ist, muss es mit einer include-Anweisung in die Modelldatei aufgenommen werden, auf der das Dashboard basiert.

Es ist üblich, alle LookML-Dashboards mit einem Platzhalter in ein Modell einzubeziehen:

include: "*.dashboard.lookml"

Wenn sich Ihre LookML-Dashboards in einem Ordner in der IDE befinden, verwenden Sie den Pfad zu ihrem Speicherort.

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

Sie können auch ein bestimmtes Dashboard einbeziehen, indem Sie den Dateinamen angeben:

include: "my_dashboard.dashboard.lookml"

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

So rufen Sie die 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. Nehmen Sie das Dashboard in die entsprechende Modelldatei auf und speichern Sie die Änderungen an dieser Datei.
  3. Klicken Sie in der Datei .dashboard.lookml, deren Vorschau Sie aufrufen möchten, auf den Pfeil nach unten Dateiaktionen ansehen und wählen Sie Dashboard ansehen aus.

Sie können weitere Änderungen an Ihrer .dashboard.lookml-Datei vornehmen, sie speichern und sich das Dashboard noch einmal in der Vorschau ansehen.

Wenn Sie mit Ihrem Dashboard zufrieden sind, können Sie es in der Produktion veröffentlichen, sodass andere Nutzer mit den entsprechenden Berechtigungen es sehen können. Die Methode zum Veröffentlichen des Dashboards ist dieselbe wie beim Veröffentlichen anderer Änderungen an LookML in Ihrer Instanz und hängt von den Einstellungen für die Versionsverwaltung für Ihre Looker-Instanz ab.

Ordner „LookML-Dashboards“

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

  • Sie müssen ein LookML-Dashboard in mindestens eine Modelldatei einbeziehen, damit es im Ordner LookML-Dashboards angezeigt wird.
  • Damit Nutzer den Ordner LookML-Dashboards sehen können, benötigen sie die Berechtigung see_lookml_dashboards.
  • Damit Nutzer Dashboards im Ordelf LookML-Dashboards sehen können, müssen sie Zugriff auf das LookML-Modell haben, das das Dashboard enthält.
  • Damit Dashboardbetrachter ein bestimmtes Tile in einem LookML-Dashboard sehen können, müssen sie Zugriff auf das LookML-Modell haben, auf dem das Tile 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.
  • Wenn Dashboardbetrachter für ein bestimmtes Tile in einem Dashboard die Option Von hier aus Explore verwenden möchten, benötigen sie die Berechtigung explore für das Modell, auf dem das Tile basiert.
  • Sie können im Ordner LookML-Dashboards keinen Ordner erstellen.
  • Im Produktionsmodus ist die Liste des Ordners LookML-Dashboards paginiert (30 Dashboards pro Seite). Im Entwicklermodus befinden sich alle LookML-Dashboards auf einer einzigen Seite.
  • Jedes LookML-Dashboard wird im Ordner LookML-Dashboards nach dem LookML-Dashboardnamen sortiert, der im LookML-Code für das Dashboard definiert ist, nicht nach dem LookML-Dashboardtitel. Daher werden die Dashboards möglicherweise nicht alphabetisch nach Titel sortiert angezeigt.

LookML-Dashboards aus dem Ordner „LookML-Dashboards“ verschieben

Wenn Sie die see_lookml_dashboards und develop Looker-Berechtigungen sowie Zugriff auf das LookML-Modell haben, in dem ein LookML-Dashboard enthalten ist, können Sie ein LookML-Dashboard in einen beliebigen Ordner verschieben, für den Sie die Zugriffsebene 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 Dokumentationsseite Inhalte organisieren und verwalten.
  • Klicken Sie im Ordner LookML-Dashboards auf das Dreipunkt-Menü für das Dashboard, wählen Sie im Menü Verschieben aus und wählen Sie den Ordner aus, in den Sie das Dashboard verschieben möchten.

Wenn Sie sich im Entwicklermodus befinden, können Sie LookML-Dashboards nicht aus dem Ordner LookML-Dashboards verschieben. Stattdessen können Sie die Option Importieren verwenden, um das LookML-Dashboard als benutzerdefiniertes Dashboard zu kopieren in einen anderen Ordner.

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 ein LookML-Dashboard aus dem Ordner LookML-Dashboards verschoben wird, erbt es die Zugriffskontrollen des Zielordners. Damit Nutzer (einschließlich eingebetteter Nutzer) ein LookML-Dashboard in einem anderen Ordner sehen können, benötigen sie zusätzlich zum Zugriff auf den Zielordner und das LookML-Modell des Dashboards die Berechtigung see_looks oder see_user_dashboards. Nutzer, die nur die see_lookml_dashboards Berechtigung haben, können LookML-Dashboards, die aus dem Ordner LookML-Dashboards verschoben wurden, nicht sehen.

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-Code für ein vorhandenes LookML-Dashboard anzeigen

Wenn Sie die see_lookml Berechtigung haben, können Sie zum LookML-Code für das Dashboard eines vorhandenen LookML-Dashboards navigieren, indem Sie im Dreipunkt-Menü Dashboard-Aktionen eines Dashboards die Option Zu LookML wechseln auswählen:

Bei Auswahl von 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 es erweitern. So können Sie ein zweites Dashboard erstellen, das auf dem ursprünglichen basiert, und dabei möglicherweise einige Einstellungen hinzufügen oder überschreiben. Wenn Sie dann das erste Dashboard ändern, werden diese Änderungen automatisch auf das zweite Dashboard übertragen (sofern sie nicht im zweiten Dashboard überschrieben werden). Weitere Informationen finden Sie auf der Dokumentationsseite Code mit „extends“ wiederverwenden.

Dashboard-Agenten zu LookML-Dashboards hinzufügen

Sie können Daten-Agenten für Conversational Analytics Dashboard für Ihre LookML-Dashboards konfigurieren. Mit Dashboard-Agenten können Betrachter über eine Chat-Oberfläche in natürlicher Sprache Fragen zu Dashboarddaten stellen.

So konfigurieren Sie einen Dashboard-Agenten für ein LookML-Dashboard:

  1. Definieren Sie einen Dashboard-Agenten in einer LookML-Datei mit dem agent-Parameter mit is_dashboard_agent: yes und Ihren benutzerdefinierten instructions.
  2. Verknüpfen Sie den Agenten in Ihrer .dashboard.lookml-Datei mit den Parametern default_dashboard_agent oder dashboard_agents und steuern Sie den Chat-Zugriff mit enable_dashboard_agent.
- dashboard: sales_overview
  title: "Sales Overview"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent
  dashboard_agents: [sales_dashboard_agent, regional_sales_agent]

Sie können Agentenanweisungen und -verhalten im Entwicklermodus testen, bevor Sie sie in der Produktion bereitstellen. Ausführliche Informationen zum Konfigurieren, Testen und Verwalten von LookML-Dashboard-Agenten finden Sie auf der Dokumentationsseite Daten-Agenten für LookML-Dashboards erstellen und verwalten.

Dashboard-Leistung mit Aggregatfunktion verbessern

LookML-Entwickler können eventuell die Leistung von LookML-Dashboards mit der Aggregatfunktion verbessern. Mit der Aggregatfunktion können Entwickler aggregierte Tabellen unter LookML-explore-Parametern erstellen und so Abfragen für eine oder mehrere Tiles in einem Dashboard optimieren.

Nachdem Sie ein LookML-Dashboard erstellt und aufgerufen haben, können Sie im Dreipunkt-Menü Dashboard-Aktionen die Option LookML-Code für aggregierte Tabelle abrufen verwenden. Diese Option ist sichtbar, wenn Sie die Berechtigung see_lookml haben.

Weitere Informationen finden Sie auf der Dokumentationsseite zum aggregate_table Parameter.