LookML-Dashboards werden von LookML-Entwicklern erstellt und als versionsgesteuerte Dateien gespeichert. Sie werden standardmäßig im Ordner LookML-Dashboards Ihrer Looker-Instanz angezeigt.
Wenn Sie LookML-Dashboards und benutzerdefinierte Dashboards vergleichen und von diesen unterscheiden möchten, sehen Sie sich die Dokumentation Vergleich von benutzerdefinierten und LookML-Dashboards an.
Zum Erstellen eines LookML-Dashboards benötigen Sie die folgenden Looker-Berechtigungen:
Außerdem müssen Sie für die Daten, die Sie im Dashboard verwenden möchten, Zugriff auf die LookML-Modelle haben.
LookML-Dashboarddatei erstellen
Wenn Sie ein LookML-Dashboard erstellen möchten, erstellen Sie zuerst eine Dashboard-Datei mit der Erweiterung .dashboard.lookml
. Der .lookml
-Abschnitt der Erweiterung ist in der IDE jedoch stummgeschaltet. Gehen Sie dazu so vor:
- Aktivieren Sie den Entwicklungsmodus.
- Gehen Sie im Menü Develop zum Projekt.
Klicken Sie oben im Dateibrowser in der Looker-IDE auf das Symbol Datei oder Ordner hinzufügen, um außerhalb von vorhandenen Projektordnern eine LookML-Dashboard-Datei 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 Dashboard-Datei zu erstellen.
Das Fenster Datei erstellen wird angezeigt. Geben Sie im Fenster den Namen der Dashboard-Datei in das Textfeld ein und wählen Sie Erstellen aus.
LookML-Dashboarddateien bearbeiten
Wenn Sie eine LookML-Dashboard-Datei erstellen, werden in der Looker-Datei bereits einige Dashboard-Parameter eingefügt, mit denen Einstellungen für das gesamte Dashboard implementiert werden. Außerdem werden dort einige Beispielparameter für das Dashboard voreingestellt, die unter dem Parameter elements
gruppiert sind und die Funktion und das Erscheinungsbild von Dashboard-Kacheln, Text und Schaltflächen definieren. Eine neu erstellte Datei .dashboard.lookml
enthält das gleiche 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 nach Bedarf in der IDE bearbeiten, solange 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-Element-Parametern erstellen.
- Benutzerdefiniertes Dashboard kopieren:Sie können eine Kopie eines benutzerdefinierten Dashboards erstellen, indem Sie das vorausgefüllte Dashboard-LookML aus der Datei löschen, das Dashboard-LookML aus einem benutzerdefinierten Dashboard kopieren und es in Ihre Dashboard-Datei einfügen.
- LookML der Dashboard-Elemente kopieren:Sie können das Dashboard-LookML aus einem Look oder einem Look kopieren und in Ihre Dashboard-Datei einfügen.
Beachten Sie beim Erstellen eines Dashboards die Best Practices für die Dashboard-Erstellung. Informationen und Empfehlungen zum Erstellen leistungsstarker Dashboards finden Sie auf der Seite Hinweise zum Erstellen leistungsstarker Looker-Dashboards.
Einem vorhandenen LookML-Dashboard eine Visualisierung hinzufügen
Die einfachste Möglichkeit, einem vorhandenen LookML-Dashboard eine Visualisierung hinzuzufügen, ist die Erstellung einer Abfrage auf der Seite „Entdecken“, die in ein Dashboard-Element umgewandelt werden soll:
- Wenn Sie die Abfrage und Visualisierung erstellt haben, die Sie einem Dashboard hinzufügen möchten, klicken Sie auf das Zahnradmenü Erkunden.
Wählen Sie GetML aus, um das LookML freizugeben.
Das Fenster LookML abrufen wird angezeigt. Wählen Sie im Fenster Dashboard aus und wählen Sie das gesamte LookML aus und kopieren Sie es.
Fügen Sie hier das LookML ein und fügen Sie es in die LookML-Datei Ihres Dashboards ein. Achten Sie beim Bearbeiten der LookML-Dashboard-Datei auf Folgendes:
- Prüfen Sie, ob Sie sich im Entwicklungsmodus befinden, damit Sie die Dashboard-Datei bearbeiten können.
- Fügen Sie das LookML unter dem Parameter
elements
des Dashboards ein. - Verwenden Sie beim Einfügen von LookML in die Dashboard-Datei den korrekten Einzug. Passen Sie den Einzug nach Möglichkeit den vorhandenen Elementen in der Dashboard-Datei an.
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 die Dashboard-Betrachter einige oder alle Elemente in einem Dashboard filtern können. Filter können aus vielen möglichen Gründen nützlich sein, z. B.:
- Angezeigten Zeitraum anpassen
- Anpassen der angezeigten Produktkategorie, des Kundentyps usw.
- Bereitstellung einer Funktion vom Typ „Suchanfrage“ für einen oder mehrere Kunden
Erstellen Sie unbedingt den gewünschten Filtertyp. Es gibt zwei Arten:
- Filter, die in den Dashboard-Elementen hartcodiert wurden und die Betrachter nicht bearbeiten können
- Dashboard-Filter, die Dashboard-Betrachter ändern können
In Dashboard-Elemente hartcodierte Filter
Filter, die in den Dashboard-Elementen hartcodiert werden und von Nutzern nicht geändert werden können, werden in der Regel automatisch im Kopierschritt von LookML für eine Visualisierung oder für ein Dashboard erstellt. In einem LookML-Dashboard verwenden diese Filter den Parameter des filters
-Dashboard-Elements und sehen so aus:
- 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 dessen Unterparametern. - Wenden Sie den Dashboard-Filter mit dem Parameter des
listen
-Dashboard-Elements auf Dashboard-Elemente an.
Dashboard-Filter erstellen
Zuerst müssen Sie die Filter erstellen, mit denen Nutzer interagieren. Fügen Sie dazu Ihrer Dashboard-Datei einen filters
-Abschnitt hinzu. Dieser sieht in etwa so aus:
- 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 zu Dashboard-Parametern ausführlicher beschrieben. Sie sollten vor allem wissen, welche Art von Eingabe Sie von Ihren Nutzern erwarten. Wenn Sie dem Filter ein type
zuweisen, wird ein bestimmter Eingabetyp wie Zahlen, Datumsangaben oder Strings akzeptiert. Sie können auch den Filter type
verwenden, um einen Filter mit einem zugewiesenen LookML-Feld zu verknüpfen. In diesem Fall wählt Looker automatisch den richtigen Eingabetyp aus. Wenn das zugrunde liegende LookML-Feld den Typ type: string
hat, erhalten Sie Dashboard-Betrachter Filtervorschläge.
Wie auf der Seite Dashboard-Parameter beschrieben, werden nur Filter mit
type: field filter
die Parameterexplore
undfield
verwendet. Wenn Sie die Parameterexplore
undfield
in einen anderen Filtertyp aufnehmen, erhalten Sie LookML-Validierungsfehler.
Dashboard-Filter auf Dashboard-Elemente anwenden
Nachdem Sie einen Dashboard-Filter erstellt haben, müssen Sie ihn mithilfe des Parameters listen
auf die richtigen Elemente anwenden. Die Idee ist, dass das Element einen oder mehrere Filter für Nutzereingaben hört und dann entsprechend anpasst. Dieser Parameter gilt für alle Elementtypen außer type: text
und type: button
. Details zur Verwendung finden Sie auf den Dokumentationsseiten der einzelnen Visualisierungstypen. Ein repräsentatives Beispiel für die Funktionsweise von listen
finden Sie unter Flächendiagrammparameter für LookML-Dashboards.
Angenommen, ein Element sieht so aus:
- 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 einen Parameter filters
. Damit wird das Element mithilfe des Filters order.status: 'approved'
auf genehmigte Aufträge beschränkt. Dies kann vom Nutzer nicht geändert werden.
Angenommen, der Nutzer soll dieses Element mithilfe der in diesem Beispiel zuvor erstellten Dashboard-Filter filtern können. Fügen Sie dazu einen listen
-Parameter wie den folgenden 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 Datum oder Kategorie anpassen können, fügen Sie einfach nicht den Parameter listen
hinzu. Du musst den Elementen nur ein listen
hinzufügen, das der Nutzer anpassen kann.
Sie sehen, dass die listen
-Syntax funktioniert, indem Sie zuerst den Namen des von Ihnen erstellten Filters und dann den Namen des Felds schreiben, auf das Sie die Nutzereingabe anwenden möchten.
Ein Dashboard-Filter lässt sich auf jedes Feld desselben Datentyps in einem beliebigen Element anwenden. Beispielsweise kann die Eingabe eines Nutzers über das Element auf das Erstellungsdatum des Auftrags (date: order.created_date
) angewendet werden, während das andere auf das Datum Versand des Auftrags (date: order.ship_date
) angewendet wird:
- 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 im Vorschaumodus oder in der Produktion als Vorschau angesehen werden kann, muss es in der Modelldatei enthalten sein, auf der das Dashboard basiert. Dazu verwenden Sie eine include
-Anweisung.
Eine gängige Praxis ist die Einbindung aller LookML-Dashboards in ein Modell mithilfe eines Platzhalters:
include: "*.dashboard.lookml"
Wenn Ihre LookML-Dashboards in einem Ordner in der IDE erscheinen, verwenden Sie den Pfad zu ihrem 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, als Vorschau ansehen und veröffentlichen
So rufen Sie die Vorschau des Dashboards auf:
- Speichern Sie die Datei
.dashboard.lookml
, indem Sie rechts oben in der Datei auf die Schaltfläche Änderungen speichern klicken. - Nehmen Sie das Dashboard in die entsprechende Modelldatei auf und speichern Sie die Änderungen an dieser Datei.
- Klicken Sie in der Datei
.dashboard.lookml
, die Sie sich in der Vorschau ansehen 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, sie speichern und sich noch einmal eine Vorschau des Dashboards anzeigen lassen.
Wenn Sie mit Ihrem Dashboard zufrieden sind, können Sie es in der Produktion veröffentlichen. So sehen andere Nutzer die entsprechenden Berechtigungen. Die Methode zum Veröffentlichen des Dashboards entspricht der Veröffentlichung anderer Änderungen an LookML in Ihrer Instanz und hängt von den Einstellungen der Versionsverwaltung für Ihre Looker-Instanz ab.
LookML-Dashboardordner
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 vielerlei Hinsicht von anderen Ordnern:
- Sie müssen in mindestens einer Modelldatei ein LookML-Dashboard einfügen, damit es im Ordner LookML-Dashboards erscheint.
- Um den Ordner LookML-Dashboards sehen zu können, benötigen Nutzer die Berechtigung
see_lookml_dashboards
. - Um Dashboards im Ordner LookML-Dashboards zu sehen, müssen Nutzer Zugriff auf das LookML-Modell haben, das das Dashboard enthält.
- Wenn Sie sich eine bestimmte Kachel in einem LookML-Dashboard ansehen möchten, 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. - Wenn Sie auf einer beliebigen Kachel in einem Dashboard die Option Hier ansehen verwenden möchten, müssen Dashboard-Betrachter die Berechtigung
explore
für das Modell haben, auf dem die Kachel basiert. - Sie können keinen Ordner im Ordner LookML-Dashboards erstellen.
LookML-Dashboards aus dem LookML-Dashboardordner verschieben
Wenn Sie die Looker-Berechtigungen für 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 Zugriffsebene Zugriff verwalten, bearbeiten haben.
Es gibt zwei Möglichkeiten, das Dashboard zu verschieben:
- Wählen Sie im Ordner LookML-Dashboards das Dashboard aus, das Sie verschieben möchten, 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 aus und dann den Ordner, in den Sie das Dashboard verschieben möchten.
Wenn Sie sich im Entwicklungsmodus befinden, können Sie keine LookML-Dashboards aus dem LookML-Dashboard 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 mit benutzerdefinierten und LookML-Dashboards 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 nicht umbenannt oder in den Papierkorb verschoben werden.
Wenn der Wert des Parameters dashboard
eines LookML-Dashboards geändert wird, wird das LookML-Dashboard automatisch zurück in den Ordner LookML-Dashboards verschoben.
LookML für ein vorhandenes LookML-Dashboard aufrufen
Wenn Sie die Berechtigung see_lookml
haben, können Sie das Dashboard von LookML für ein vorhandenes LookML-Dashboard aufrufen. Wählen Sie dazu im Dashboard mit drei Punkten Dashboard-Aktionen die Option Zu LookML aus:
Wenn Sie Zu LookML auswählen, ruft Looker die Dashboard-Datei auf, 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 Dashboard basiert. Dadurch werden möglicherweise einige Einstellungen hinzugefügt oder überschrieben. Wenn Sie dann das erste Dashboard ändern, werden die Änderungen automatisch auf das zweite übernommen (es sei denn, es wird im zweiten Dashboard überschrieben). Weitere Informationen finden Sie auf der Dokumentationsseite Wiederverwenden von Code mit Erweiterungen.
Dashboard-Leistung mit Aggregatfunktion verbessern
LookML-Entwickler können die Leistung des LookML-Dashboards unter Umständen mit der zusammengefassten Markenbekanntheit verbessern. Mit der aggregierten Bekanntheit können Entwickler unter den LookML-explore
-Parametern zusammengefasste Tabellen 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 es aufrufen, können Sie die Option GetML-Tabelle in LookML abrufen im Dreipunkt-Menü Dashboard-Aktionen verwenden, das sichtbar ist, wenn Sie die Berechtigung see_lookml
haben.
Weitere Informationen finden Sie auf der Dokumentationsseite zu aggregate_table
-Parametern.