Sie sehen sich die Dokumentation für Looker 22.16 an. Die aktuelle Dokumentation finden Sie hier.

LookML-Dashboards erstellen

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

Einen Vergleich und einen Unterschied zwischen 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:

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

LookML-Dashboard-Datei erstellen

Zum Erstellen eines LookML-Dashboards erstellen Sie zuerst eine Dashboard-Datei mit der Erweiterung .dashboard.lookml (obwohl der Teil .lookml der Erweiterung in der IDE stumm geschaltet ist). Dazu gehen Sie so vor:

Aktivieren Sie den Entwicklungsmodus.
Rufen Sie im Menü Entwickeln Ihr Projekt auf.
Wählen Sie oben im Dateibrowser in der Looker-IDE das Symbol 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 klicken, um die Datei im Ordner zu erstellen. Klicken Sie auf Dashboard erstellen, um die Dashboard-Datei zu erstellen.
Das Fenster Datei erstellen wird angezeigt. Benennen Sie im Dashboard den Namen der Dashboard-Datei im Feld „Schreiben“ und wählen Sie Erstellen aus.

LookML-Dashboard-Dateien bearbeiten

Wenn Sie eine LookML-Dashboard-Datei erstellen, werden von Looker vorab einige grundlegende Dashboard-Parameter in die Datei eingefügt, mit denen Einstellungen für das gesamte Dashboard implementiert werden. Außerdem werden in der Datei mehrere Beispiele für Dashboard-Elementparameter vorab ausgefüllt. Diese sind unter dem Dashboard-Parameter elements gruppiert und definieren die Funktion und das Design von Dashboard-Kacheln, Text und Schaltflächen. Eine neu erstellte .dashboard.lookml-Datei enthält das folgende LookML-Dashboard:

- 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, sofern Sie sich im Entwicklungsmodus befinden.

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

Manuelles Erstellen: 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. Löschen Sie dazu das vorausgefüllte Dashboard-LookML aus der Datei, kopieren Sie das Dashboard-LookML aus einem benutzerdefinierten Dashboard und fügen Sie es in Ihre Dashboard-Datei ein.
Dashboard-LookML von Elementen kopieren: Sie können die LookML-Dashboard-Elemente aus einem Look oder einem Look kopieren und in Ihre Dashboard-Datei einfügen.

Berücksichtigen Sie beim Erstellen eines Dashboards die Best Practices für die Dashboard-Erstellung. Informationen und Empfehlungen zum Erstellen leistungsstarker Dashboards finden Sie im Artikel Überlegungen zum Erstellen leistungsstarker Looker-Dashboards.

Visualisierung zu einem vorhandenen LookML-Dashboard hinzufügen

Am einfachsten fügen Sie eine Visualisierung zu einem vorhandenen LookML-Dashboard hinzu, indem Sie auf der Erkundungsseite eine Abfrage erstellen, die in ein Dashboard-Element umgewandelt werden soll:

Wenn Sie die Abfrage und die Visualisierung erstellt haben, die Sie einem Dashboard hinzufügen möchten, klicken Sie im Zahnradmenü auf Erkunden.
Wählen Sie GetMLML abrufen aus, um LookML bereitzustellen.
Das Fenster LookML wird angezeigt. Wählen Sie im Fenster Dashboard aus und wählen Sie das gesamte LookML aus und kopieren Sie es.

Fügen Sie nun LookML in die LookML-Datei Ihres Dashboards ein. Achten Sie beim Bearbeiten der LookML-Dashboard-Datei auf Folgendes:

Achten Sie darauf, dass 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.
Verwenden Sie beim Einfügen von LookML in die Dashboard-Datei den korrekten Einzug. Stimmen Sie den Einzug nach Möglichkeit den vorhandenen Elementen in der Dashboard-Datei zu.

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

Filter hinzufügen

Wenn 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 verschiedenen Gründen nützlich sein. Beispiele:

Angezeigten Zeitraum anpassen
Angezeigte Produktkategorie, Kundentyp usw. anpassen
Einen Clienttyp oder eine Funktion für die Suche bereitstellen

Erstellen Sie unbedingt den gewünschten Filter. Es gibt zwei Typen:

Filter, die in den Dashboard-Elementen hartcodiert werden können und die Betrachter des Dashboards nicht ändern können
Dashboard-Filter, die Nutzer von Dashboards ändern können

Filter, die in Dashboard-Elemente hartcodiert sind

Filter, die Sie in die Dashboard-Elemente hartcodieren können und die Nutzer nicht ändern können. Sie werden normalerweise automatisch im LookML-Schritt kopiert, um eine Visualisierung zu erstellen oder für ein Dashboard. In einem LookML-Dashboard wird in diesen Filtern der Parameter des filters-Dashboard-Elements verwendet:

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

Dashboard-Filter

Dashboard-Filter lassen sich in zwei Schritten erstellen:

Erstellen Sie den Dashboard-Filter selbst mit dem Dashboard-Parameter filters und den zugehörigen Unterparametern.
Mit dem Dashboard-Parameter listen können Sie den Dashboard-Filter auf Dashboard-Elemente anwenden.

Dashboard-Filter erstellen

Im ersten Schritt erstellen Sie die Filter, mit denen Nutzer interagieren. Fügen Sie dazu Ihrer Dashboard-Datei einen filters-Abschnitt hinzu, der in etwa so aussieht:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  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

Die verschiedenen Optionen und Parameter für diese Filter werden auf der Dokumentationsseite Dashboard-Parameter genauer beschrieben. Sie sollten vor allem wissen, welche Art von Eingabe Sie von Ihren Nutzern erwarten. Sie können dem Filter ein type zuweisen. Dadurch akzeptiert es einen bestimmten Eingabetyp, z. B. Zahlen, Datumsangaben oder Strings. Sie können auch den Filter type verwenden, um einen Filter mit einem zugrunde liegenden LookML-Feld zu verknüpfen. In diesem Fall wählt Looker automatisch den richtigen Eingabetyp aus. Wenn das zugrunde liegende LookML-Feld auf type: string gesetzt ist, erhalten Sie Dashboard-Betrachtern Filtervorschläge.

Wie auf der Seite Dashboard-Parameter beschrieben, verwenden nur Filter mit type: field filter die Parameter explore und field. Wenn Sie die Parameter explore und field in einen anderen Filtertyp aufnehmen, erhalten Sie LookML-Validierungsfehler.

Dashboard-Filter auf Dashboard-Elemente anwenden

Nachdem Sie einen Dashboard-Filter erstellt haben, wenden Sie ihn mit dem Parameter listen auf die richtigen Elemente an. Bei diesem Element wird ein oder mehrere Filter für die Nutzereingabe berücksichtigt und dann entsprechend angepasst. Dieser Parameter gilt für alle Elementtypen außer type: text und type: button. Details zur Verwendung finden Sie auf den Dokumentationsseiten für jeden einzelnen Visualisierungstyp. Ein repräsentatives Beispiel für die Funktionsweise von listen finden Sie unter Parameter für Flächendiagramme für LookML-Dashboards.

Ein Beispiel:

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

Wie Sie sehen, hat dieses Element bereits den Parameter filters, mit dem das Element mithilfe des Filters order.status: 'approved' auf genehmigte Aufträge beschränkt wird. Dies kann vom Nutzer nicht geändert werden.

Angenommen, Sie möchten, dass der Nutzer dieses Element mithilfe der zuvor in diesem Beispiel erstellten Dashboard-Filter filtern kann. Fügen Sie dazu einen listen-Parameter wie diesen hinzu:

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

Wenn Sie nicht möchten, dass Nutzer das Datum oder die Kategorie anpassen können, fügen Sie einfach nicht den Parameter listen hinzu. Du musst den Elementen, die der Nutzer anpassen kann, nur listen hinzufügen.

Sie sehen, dass die Syntax listen funktioniert, indem Sie zuerst den Namen des erstellten Filters und dann den Namen des Feldes schreiben, auf das die Nutzereingabe angewendet werden soll.

Ein Dashboard-Filter kann auf jedes Feld desselben Typs in jedem Element angewendet werden. Beispielsweise kann ein Element die Eingabe eines Nutzers auf das Erstellungsdatum (date: order.created_date) des Auftrags und ein anderes auf das Versanddatum (date: order.ship_date) eines Auftrags anwenden:

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

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

Dashboard-Datei in ein Modell aufnehmen

Damit Ihr Dashboard für die Vorschau im Entwicklungsmodus oder in der Produktionsumgebung sichtbar ist, muss es in der Modelldatei enthalten sein, auf der das Dashboard basiert. Dazu verwenden Sie eine include-Anweisung.

Häufig werden alle LookML-Dashboards mithilfe eines Platzhalters in ein Modell aufgenommen:

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 hinzufügen, indem Sie seinen Dateinamen angeben:

include: "my_dashboard.dashboard.lookml"

LookML-Dashboard speichern, als Vorschau ansehen und veröffentlichen

So rufen Sie die Vorschau des Dashboards auf:

Klicken Sie rechts oben auf die Schaltfläche Änderungen speichern, um die Datei .dashboard.lookml zu speichern.
Nehmen Sie das Dashboard in die relevante Modelldatei auf und speichern Sie die Änderungen an dieser Datei.
Klicken Sie in der Datei .dashboard.lookml, für die Sie eine Vorschau sehen möchten, auf den Abwärtspfeil Dateiaktionen ansehen und wählen Sie Dashboard ansehen aus.

Sie können weitere Änderungen an Ihrer .dashboard.lookml-Datei vornehmen, diese speichern und sich dann noch einmal eine Vorschau des Dashboards ansehen.

Wenn Sie mit Ihrem Dashboard zufrieden sind, können Sie es in der Produktion veröffentlichen und anderen Nutzern mit den entsprechenden Berechtigungen anzeigen. Die Methode zum Veröffentlichen des Dashboards ist mit der Veröffentlichung anderer Änderungen an LookML auf der Instanz identisch. Die Methode hängt von den Einstellungen der Versionsverwaltung der Looker-Instanz ab.

LookML-Dashboards-Ordner

Nach der Veröffentlichung werden LookML-Dashboards standardmäßig im Ordner LookML-Dashboards gespeichert. Der Ordner LookML-Dashboards befindet sich im linken Navigationsbereich im Ordner Ordner. 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 Sie den Ordner LookML-Dashboards sehen können, benötigen Sie die Berechtigung see_lookml_dashboards.
Damit Dashboards im Ordner LookML-Dashboards angezeigt werden, müssen Nutzer Zugriff auf das LookML-Modell haben, das das Dashboard enthält.
Dashboard-Viewer müssen Zugriff auf das LookML-Modell haben, auf dem die jeweilige Kachel basiert.
Zum Bearbeiten eines Dashboards im Ordner LookML-Dashboards benötigen Sie die Berechtigung develop für das Modell, das das LookML-Dashboard enthält.
Zum Erkunden von hier auf einer beliebigen Kachel in einem Dashboard müssen Dashboard-Betrachter die Berechtigung explore für das Modell haben, auf dem die Kachel basiert.
Sie können im Ordner LookML-Dashboards keinen Ordner erstellen.

LookML-Dashboards aus dem LookML-Dashboardordner 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 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 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ü für das Dashboard, 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 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 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 in einen Ordner umbenannt oder in den Papierkorb verschoben werden.

Wenn Sie den Wert eines Parameters dashboard ändern, wird das LookML-Dashboard automatisch zurück in den Ordner LookML-Dashboards verschoben.

LookML für ein vorhandenes LookML-Dashboard ansehen

Wenn Sie die Berechtigung see_lookml haben, können Sie zum LookML-Dashboard eines vorhandenen LookML-Dashboards gehen, indem Sie im Dashboard das Dreipunkt-Menü Dashboard-Aktionen auswählen.

Wenn das LookML-Dashboard das alte Dashboard-Design hat, klicken Sie im Zahnradmenü auf LookML aufrufen.

Wenn Sie Go LookLook auswählen, navigiert Looker zur 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 auf dem ursprünglichen Dashboard basierendes Dashboard erstellen und einige Einstellungen hinzufügen oder überschreiben. Wenn Sie dann das erste Dashboard ändern, werden die Änderungen automatisch für das zweite übernommen (sofern es nicht im zweiten Dashboard überschrieben wurde). Weitere Informationen finden Sie auf der Dokumentationsseite Code mit Erweiterungen wiederverwenden.

Dashboard-Leistung mit Aggregatfunktion verbessern

LookML-Entwickler können die Leistung des LookML-Dashboards möglicherweise mithilfe der aggregierten Bekanntheit verbessern. Mit der aggregierten Markenbekanntheit können Entwickler zusammengefasste Tabellen unter den LookML-explore-Parametern erstellen, mit denen Abfragen für eine oder mehrere Kacheln in einem Dashboard optimiert werden können.

Nachdem Sie ein LookML-Dashboard erstellt haben und ansehen, können Sie die Option Aggregierte Tabellen-LookML abrufen über das Dreipunkt-Menü Dashboard-Aktionen verwenden. Diese Option ist sichtbar, wenn Sie die Berechtigung see_lookml haben:

Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter aggregate_table.