Sie können mithilfe einer Reihe von LookML-Parametern Ihre Explores benutzerfreundlicher gestalten, indem Sie die Anzeige von Feldern in der Benutzeroberfläche ändern, ohne die zugrundeliegende LookML zu verändern. Diese Seite bietet einen Überblick über LookML-Parameter, die die Darstellung des Looker-Menüs „Explore“ und des Field Pickers ändern.
| In Looker können Ihre Nutzer Explores im Menü Explore sehen. | In einem Explore können Nutzer mit der Feldauswahl die Felder (Dimensionen und Messwerte) auswählen, die zum Abfragen ihrer Daten verwendet werden sollen. |
|
|
Auf dieser Seite sind alle häufig verwendeten Parameter mit einem Link zur vollständigen Referenzseite, einer kurzen Beschreibung seiner Funktion und einem Bild des Ergebnisses aufgeführt.
Tipps und Vorschläge zum Erstellen nutzerfreundlicher Explores finden Sie auf der Seite mit den Best Practices unter Best Practice: Ein positives Erlebnis für Looker-Nutzer schaffen.
Explore-Name und -Menü
In diesem Abschnitt werden das Standardverhalten für den Namen und die Darstellung eines Explores im Menü Explore beschrieben. Außerdem werden die LookML-Parameter beschrieben, mit denen Sie dieses Verhalten ändern können:
Standardverhalten des Menüs „Explore“
Modellnamen
Das Menü Explore ist standardmäßig nach Modellnamen organisiert, die durch den Namen der jeweiligen Modelldatei bestimmt werden. Das Menü Explore zeigt eine formatierte Version des Modellnamens an, wobei Unterstriche in Leerzeichen geändert und jedes Wort großgeschrieben werden. Unter dem jeweiligen Modellnamen befindet sich eine Liste der in dieser Modelldatei definierten Explores.
Explore-Namen
Der Name jedes Explore im Menü basiert auf dem entsprechenden explore-Parameter in der Modelldatei. Wie bei Modelnamen auch werden für Explore-Namen Unterstriche in Leerzeichen geändert, und jedes Wort fängt mit einem Großbuchstaben an. Der Explore-Name wird auch als Explore-Titel im Feldauswahlbereich angezeigt.
Im folgenden Beispiel ist das Explore order_items in der Modelldatei e_commerce_model.model definiert:
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
Das Explore order_items wird im Explore-Menü und im Field Picker als Order Items (Bestellelemente) angezeigt.
| Menü „Explore“: | Field Picker: |
 |
 |
Weitere Informationen zu Modelldateien finden Sie auf der Dokumentationsseite Informationen zu Modelldateien und zum Anzeigen von Dateien. Weitere Informationen zum Definieren von Explores finden Sie auf der Dokumentationsseite zum Parameter explore.
label (Modell)
Mit dem Parameter label eines Modells wird ein Modell im Menü Explore umbenannt, ohne dass sich der Verweis auf das Modell in LookML ändert. Für Explore-URLs spiegeln die Looker-IDE und SQL Runner weiterhin den tatsächlichen Modellnamen wieder. Die Änderung hat keine Auswirkungen auf den Verweis auf das Modell in LookML, und die Admin-Einstellungen bleiben unverändert.
Standardmäßig wird das Modell market_research.model im Menü „Explore“ als Marktforschung angezeigt.
Mit dem Parameter label können Sie das Modell im Menü „Explore“ umbenennen. Beispielsweise fügen Sie der Modelldatei market_research.model den Code label: "Marketing R&D" hinzu:
label: "Marketing R&D"
In diesem Beispiel wird der Modellname in Looker im Menü „Explore“ wie folgt angezeigt:
label (Entdecken)
Mit dem Parameter label eines Explores wird ein Explore im Menü Explore und auf der Explore-Seite umbenannt, ohne dass sich die Referenzierung in LookML ändert.
Wenn der Parameter label nicht verwendet wird, wird der Explore-Name gemäß seinem Standardverhalten angezeigt.
group_label (Entdecken)
Mit dem Parameter group_label eines Explores wird die Standardorganisation des Menüs Explore geändert. Anstatt jedes Explore unter dem Namen seines Modells aufzulisten, können Sie mit group_label eine benutzerdefinierte Überschrift definieren, unter der ein oder mehrere Explores aufgelistet werden sollen.
In diesem Beispiel sind die Explores Customers (Kunden), Inventory (Inventar), Order Items (Bestellelemente) und User Data (Nutzerdaten) unter der Gruppenbezeichnung Online Store Queries (Anfragen im Onlineshop) aufgelistet:
description (Entdecken)
Mit dem Parameter description eines Explores können Sie der Benutzeroberfläche eine Beschreibung hinzufügen, damit Nutzer beim Erstellen von Berichten zusätzliche Informationen erhalten.
Benutzer können die Beschreibung einblenden, indem sie den Mauszeiger auf das Informationssymbol verschieben, das sich oben im Field Picker neben dem Explore-Namen befindet. Das Informationssymbol wird auch in der Dropdown-Liste der Explores angezeigt. Wenn Sie einem Explore nicht ausdrücklich eine Beschreibung hinzufügen, wird keine Beschreibung angezeigt.
hidden (Entdecken)
Mit dem Parameter hidden eines Explores wird es im Menü Explore ausgeblendet. Standardmäßig ist hidden deaktiviert und das Explore wird angezeigt. hidden blendet LookML nicht aus und verhindert nicht den Zugriff auf ein Explore über die URL. hidden ist nicht als Sicherheitsfunktion gedacht, sondern als Präsentationsfunktion.
Wenn Sie beispielsweise im folgenden Beispiel den LookML-Code hidden: yes zum LookML-Code für das Explore inventory hinzufügen, wird der Explore Inventory im Menü „Explore“ ausgeblendet:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Field Picker
In diesem Abschnitt werden das Standardverhalten des Field Pickers sowie die LookML-Parameter beschrieben, mit denen Sie dieses Verhalten ändern können.
Ändern Sie die Art und Weise, wie der Ansichtsname im Field Picker angezeigt wird:
Ändern Sie die Art und Weise, wie Namen einzelner Felder im Field Picker angezeigt werden:
Ändern Sie die Art und Weise, wie Felder im Field Picker organisiert werden:
Standardverhalten des Field Pickers
Der Field Picker ist standardmäßig nach Überschriften organisiert, die den Ansichten entsprechen, die durch den LookML-Parameter view angegeben werden. Die Felder der einzelnen Ansichten sind im Field Picker gruppiert. Die Art des Feldes (Dimension, Dimensionsgruppe, Messwert, Filterfeld und Parameterfeld) bestimmt, an welcher Stelle in der Ansicht das Feld angezeigt wird. Sofern der label-Parameter nicht verwendet wird, um den Anzeigenamen zu ändern, zeigt der Field Picker eine formatierte Version der LookML-Ansicht oder des Feldnamens an, wobei Unterstriche in Leerzeichen geändert und jedes Wort in Großbuchstaben geschrieben werden.
Im folgenden Beispiel zeigt Looker die Ansicht accounts im Field Picker als Konten an. Dies ist das Standardverhalten:
view: accounts {
sql_table_name: accounts ;;
}
Im folgenden Beispiel sehen Sie, wie die Namen einer Dimension, einer Dimensionsgruppe und eines Messwerts standardmäßig angezeigt werden. Diese Formatierung wird auf die Namen aller Filter- und Parameterfelder angewendet.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
In diesem Beispiel zeigt der Field Picker die Standardfeldnamen Kontonummer, Name, Erstellungsdatum und Durchschnittlicher Jahresumsatz für die Dimensionen account_number und name, die Dimensionsgruppe created und den Messwert average_annual_revenue an.
Wenn Sie den Namen eines Felds ändern, passt sich der Field Picker an den neuen Namen an. Sie können jedoch einen alias-Parameter mit dem alten Namen des Felds hinzufügen. Dieser Parameter stellt alternative Namen für ein Feld bereit, das bei einer Abfrage in einer URL erscheinen könnte. Das kann nützlich sein, wenn sich Feldnamen in einem Modell ändern, aber einige Nutzer Links zu Daten freigegeben haben und Sie möchten, dass die bereits vorhandenen URLs weiter funktionieren.
view_label (Entdecken)
Der Parameter view_label eines Explores ändert, wie die Gruppe von Feldern aus der Basisansicht eines Explores im Field Picker bezeichnet wird, ohne dass sich die Art und Weise ändert, wie auf das Explore und seine Felder in LookML verwiesen wird.
Wenn Sie beispielsweise eine Ansicht order_facts mit einem Explore namens order_items verknüpfen, können Sie mit dem Parameter view_label das Label festlegen, das Looker für die Ansicht order_facts im Field Picker so anzeigt:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
In diesem Beispiel wird die Ansicht order_facts im Field Picker des Explores Order Items (Bestellelemente) als Orders and more (Aufträge und mehr) angezeigt.
view_label (Mitglied werden)
Mit dem Parameter view_label eines Joins können Sie Felder aus einer Ansicht im Field Picker unter dem Namen einer anderen Ansicht gruppieren. Wenn Sie einem Join nicht explizit eine view_label hinzufügen, wird für view_label standardmäßig der Name des Joins verwendet.
Beispiel: Sie verbinden die Ansicht products mit dem Explore product_facts:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Da in diesem Beispiel kein Ansichtslabel angegeben ist, werden die Felder aus der Ansicht products im Field Picker getrennt von der Ansicht Produktfakten unter dem Ansichtslabel Produkte im Field Picker gruppiert:
Mit dem Parameter view_label können Sie der verknüpften products-Ansicht ein Ansichtslabel hinzufügen, wie im folgenden Beispiel gezeigt:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Dadurch werden die Felder aus der Ansicht products unter dem Ansichtslabel Produktfakten im Field Picker gruppiert:
label (ansehen)
Mit dem Parameter label einer Ansicht ändert sich das Label der Ansicht im Field Picker, ohne dass sich der Verweis auf die Ansicht in LookML ändert. Wenn nichts festgelegt wurde, wird der Name der Ansicht standardmäßig als Bezeichnung verwendet. Im Gegensatz zu view_label (Explore) und view_label (Join) wirkt sich dieser Parameter auf alle Explores aus, in denen die Ansicht verwendet wird.
Beispielsweise können Sie den Parameter label verwenden, um ein Label für die Ansicht inventory_items anzugeben:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
In diesem Beispiel zeigt der Field Picker das Label Items in Inventory in der Ansicht inventory_items anstelle des Standardlabels Inventory Items an.
description (Feld)
Sie können jedem Feld ein description hinzufügen. Wenn Sie bei BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, fügt Looker die Feldbeschreibungen automatisch mit den Beschreibungen aus den Metadaten der BigQuery-Spalte ein, falls vorhanden.
Der Benutzer kann diese Beschreibung an mehreren Stellen sehen. Looker zeigt die Beschreibung an, wenn der Benutzer das Informationssymbol rechts neben dem Feldnamen im Field Picker auswählt.
Darüber hinaus zeigt Looker die Beschreibung auch an, wenn der Benutzer mit der Maus auf den Spaltennamen in einer Tabellen- oder Tabellendiagramm-Visualisierung in einem Explore, einem Dashboard oder einem Look zeigt.
hidden (Feld)
Standardmäßig werden Felder, die in einer Ansicht angegeben sind, im Field Picker angezeigt. Mit dem Parameter hidden des Felds wird ein Feld im Field Picker ausgeblendet.
Auf ausgeblendete Felder kann in der Benutzeroberfläche dennoch zugegriffen werden, wenn sie der URL manuell hinzugefügt werden, und in einigen Looker-Fenstern werden sie angezeigt. Betrachten Sie hidden daher als eine Methode, um den Field Picker sauber zu halten, und nicht als Sicherheitsfunktion.
Wenn Sie beispielsweise im folgenden Beispiel den LookML-Code hidden: yes in den LookML-Code für die Dimension product_id einfügen, wird die Dimension Produkt-ID im Field Picker ausgeblendet:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (Feld)
Mit dem Parameter fields können Sie angeben, welche Felder aus der Basisansicht eines Explore und aus Joins im Field Picker verfügbar sind. Wenn Sie den Parameter fields nicht verwenden, macht Looker alle Felder verfügbar.
Verwenden Sie zur Angabe der Felder, die Sie im Field Picker anzeigen möchten, eine kommagetrennte Feld- oder Satzliste. Um die Felder anzugeben, die im Field Picker ausgeblendet werden sollen, verwenden Sie den Satz ALL_FIELDS* mit einer durch Kommas getrennten Liste der auszuschließenden Felder oder Sätze mit einem Bindestrich (-) davor.
Als Beispiel können Sie den folgenden LookML-Code verwenden, um nur eine Auswahl von Feldern aus dem Explore aircraft im Field Picker anzuzeigen:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
In diesem Beispiel werden im Explore Flugzeugmodell nur die Dimensionen Modellcode des Luftfahrzeugs, Antriebscode des Flugzeugs, Stadt, Land und Postleitzahl sowie der Messwert Anzahl im Field Picker angezeigt.
label (Feld)
Mit dem Parameter label eines Felds können Sie ändern, wie ein Feldname im Field Picker angezeigt wird, ohne den Verweis in LookML zu ändern. Wenn nichts festgelegt wurde, wird der Name des Feldes standardmäßig als Bezeichnung verwendet.
So können Sie beispielsweise den Parameter label verwenden, um ein Label für die Dimension cost festzulegen:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel hat die Dimension Kosten das Label Preis im Field Picker.
view_label (Feld)
Mit dem Parameter view_label eines Felds können Sie den Namen der Ansicht ändern, unter der das Feld im Field Picker aufgeführt wird, ohne den Verweis auf das Feld in LookML zu ändern. Wenn nichts angegeben ist, wird das Feld unter der Bezeichnung für die Ansicht angezeigt, in der sie definiert wurde.
Sie können den Parameter view_label beispielsweise so verwenden, um ein Ansichtslabel für die Dimension cost anzugeben:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel wird in Looker im Field Picker die Dimension Kosten unter dem Ansichtslabel Kosteninformationen angezeigt.
group_label (Feld)
Mit dem Parameter group_label können Sie Felder in einer Ansicht im Field Picker in einer gemeinsamen Drop-down-Liste kombinieren.
In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Versandstadt, Versandland und Versandstatus:
group_item_label (Feld)
Wenn Felder unter einer Gruppenbezeichnung angezeigt werden, müssen möglicherweise nicht die vollständigen Namen oder Bezeichnungen im Field Picker erscheinen. In dem zuvor für group_label (Feld) gezeigten Beispiel gibt das Gruppenlabel bereits an, dass sich die Felder auf den Versand beziehen. In solchen Fällen können Sie den group_item_label-Parameter zu jedem dieser gruppierten Felder hinzufügen, um zu ändern, wie sie unter dem Gruppenlabel angezeigt werden.
In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Stadt, Land und Bundesland:
