LookML-Dashboards erstellen

LookML-Dashboards werden von LookML-Entwicklern erstellt und als versionierte Dateien gespeichert. Standardmäßig werden sie in der Looker-Instanz im Ordner LookML-Dashboards 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:

• see_lookml_dashboards
• develop

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

LookML-Dashboarddatei erstellen

Wenn Sie ein LookML-Dashboard erstellen möchten, müssen Sie zuerst eine Dashboarddatei mit der Erweiterung .dashboard.lookml erstellen. Der Teil .lookml der Erweiterung ist in der IDE nicht sichtbar. Gehen Sie dazu so vor:

1. Aktivieren Sie den Entwicklungsmodus.
2. Rufen Sie im Menü Entwickeln Ihr Projekt auf.
3. Klicken Sie in der Looker-IDE oben im Dateibrowserbereich auf das Pluszeichen Datei oder Ordner hinzufügen, um eine LookML-Dashboarddatei 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 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, werden in Looker mehrere grundlegende Dashboard-Parameter vorab in die Datei eingefügt, mit denen Einstellungen für das gesamte Dashboard implementiert werden. 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 LookML-Code für ein Dashboard, der in etwa 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, 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 die 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.

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

   

Fügen Sie die LookML-Datei in die LookML-Datei des Dashboards ein. Beachten Sie beim Bearbeiten der LookML-Datei des Dashboards Folgendes:

• Prüfen Sie, ob Sie sich im Entwicklungsmodus befinden, damit Sie die Dashboard-Datei bearbeiten können.
• Fügen Sie die LookML unter dem Parameter elements des Dashboards ein.
• Achten Sie beim Einfügen von LookML in die Dashboarddatei auf die richtige Einrückung. Passen Sie die Einzüge nach Möglichkeit an vorhandene Elemente in der Dashboard-Datei an.

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 von Dashboard-Besuchern nicht geändert werden können
• Dashboard-Filter, die von Dashboard-Besuchern geändert werden können

In Dashboard-Elemente hartcodierte 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 Dashboard-Elementparameter 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 Daten, die in Dashboard-Elementen angezeigt werden, interaktiv eingrenzen. So erstellen Sie einen Dashboard-Filter:

1. Erstellen Sie den Dashboard-Filter mit dem Parameter filters in Ihrer LookML-Dashboarddatei.
2. Mit dem Parameter listen können Sie den Filter auf einzelne Dashboard-Elemente anwenden.

Dashboard-Filter erstellen

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

Wenn Sie einen Dashboard-Filter erstellen möchten, mit dem Nutzer interagieren können, fügen Sie Ihrer Dashboarddatei den Parameter filters hinzu. Im folgenden Beispiel wird 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 „Letzte 30 Tage“.
• category_name: Ein Feldfilter, mit dem Nutzer nach Produktkategorie filtern können. Mit diesem Filter werden dynamisch Optionen generiert, die auf dem Feld category.name im angegebenen LookML-Modell (ecommerce) und Explore (product) basieren.

Hinweis: Die Parameter explore und field werden nur für Filter mit type: field_filter verwendet. Wenn Sie die Parameter explore und field in einen anderen Filtertyp einfügen, erhalten Sie LookML-Validierungsfehler.

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 dynamisch anhand der Auswahl des Nutzers im Filter aktualisiert werden.

Hinweis: Der Parameter listen wird von allen Elementtypen unterstützt, mit Ausnahme von type: text und type: button.

Betrachten Sie beispielsweise den folgenden LookML-Code 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'

Im Diagramm approved_orders_by_day wird die Anzahl der genehmigten Bestellungen nach Tag angezeigt, da die Abfrage auf der Dimension orders_created_date und dem Messwert orders.count basiert und der Filter orders.status: 'approved' angewendet wird. Dieser Filter ist im Element fixiert und kann von Dashboard-Besuchern nicht geändert werden.

Wenn Nutzer das Diagramm approved_orders_by_day mithilfe der Filter date und category_name aus dem vorherigen Beispiel filtern sollen, 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 category_name- oder dem date-Filter interagiert, wird das approved_orders_by_day-Diagramm automatisch aktualisiert, um die gefilterten Ergebnisse widerzuspiegeln.

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. So kann beispielsweise ein Element die Eingabe eines Nutzers auf das Datum created (date: orders.created_date) des Auftrags anwenden, während ein anderes Element sie auf das Datum ship (date: orders.ship_date) des Auftrags anwendet:

- 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

Hinweis :Bei Dashboard-Elementen, die den Parameter merged_queries verwenden, kann jede Quellabfrage auf einen oder mehrere Dashboard-Filter reagieren. Sie können die Filterlogik für jede Quellabfrage unabhängig definieren, unabhängig von der Anzahl der Quellabfragen im Element mit den zusammengeführten Ergebnissen. Wenn eine Abfrage keinen listen-Parameter hat, wird sie von keinen Dashboard-Filtern beeinflusst.

Dashboarddatei in ein Modell aufnehmen

Damit Ihr Dashboard im Entwicklungsmodus in der Vorschau oder in der Produktion sichtbar ist, muss es mithilfe einer include-Anweisung in der Modelldatei enthalten sein, auf der das Dashboard basiert.

Häufig werden alle LookML-Dashboards mit einem Platzhalter in ein Modell aufgenommen:

include: "*.dashboard.lookml"

Wenn Ihre LookML-Dashboards in der IDE in einem Ordner angezeigt werden, verwenden Sie den Pfad zu diesem 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 ansehen 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 eine Vorschau anzeigen 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.

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 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, benötigen sie die Berechtigung see_lookml_dashboards.
• Damit Nutzer Dashboards im Ordner LookML-Dashboards sehen können, müssen sie Zugriff auf das LookML-Modell haben, das das Dashboard enthält.
• Damit eine bestimmte Kachel in einem LookML-Dashboard angezeigt werden kann, 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.
• Damit Dashboard-Betrachter die Option Explore from Here (Von hier aus analysieren) für eine bestimmte Kachel in einem Dashboard verwenden können, benötigen sie die Berechtigung explore für das Modell, auf dem die 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 sich ein LookML-Dashboard befindet, 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 als auch LookML-Dashboards enthält, werden die LookML-Dashboards im Bereich 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, wird in Looker die Dashboard-Datei geöffnet, 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 in das zweite Dashboard übernommen, sofern sie dort 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 der Aggregationsfunktion können Entwickler Summentabellen unter LookML-explore-Parametern erstellen, um Abfragen für eine oder mehrere Kacheln in einem Dashboard zu optimieren.

Wenn Sie ein LookML-Dashboard erstellt und geöffnet haben, können Sie über das Dreipunkt-Menü Dashboard-Aktionen die Option LookML-Code für aggregierte Tabelle abrufen verwenden. Dieses Menü ist nur sichtbar, wenn Sie die Berechtigung see_lookml haben.

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

Hinweis: Weitere Informationen und Empfehlungen zum Erstellen leistungsstarker Dashboards finden Sie auf der Seite mit Best Practices Hinweise zum Erstellen leistungsstarker Looker-Dashboards.