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:
- Aktivieren Sie den Entwicklungsmodus.
- Rufen Sie im Menü Entwickeln Ihr Projekt auf.
- 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.
- 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:
- Nachdem Sie die Abfrage und Visualisierung erstellt haben, die Sie einem Dashboard hinzufügen möchten, klicken Sie auf das Zahnradsymbol Explore-Aktionen.
Wählen Sie LookML abrufen aus, um die LookML zu sehen.
Das Fenster LookML abrufen wird angezeigt. Wählen Sie im Fenster Dashboard aus und kopieren Sie die gesamte LookML.
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:
- Erstellen Sie den Dashboard-Filter mithilfe des Parameters
filters
in Ihrer LookML-Dashboarddatei. - 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 Feldcategory.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:
- Speichern Sie die Datei
.dashboard.lookml
, indem Sie rechts oben auf die Schaltfläche Änderungen speichern klicken. - Fügen Sie das Dashboard in die entsprechende Modelldatei ein und speichern Sie die Änderungen in dieser Datei.
- 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
.