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 „Erkunden“ und der Feldauswahl ändern.
| In Looker werden Nutzern die explorativen Datenanalysen im Menü Erkunden angezeigt. |
In einer explorativen Datenanalyse können Nutzer mithilfe der Feldauswahl die Felder (Dimensionen und Messwerte) für die Abfrage ihrer Daten auswählen. |
|
|
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 eines nutzerfreundlichen Explore finden Sie unter Best Practice: Positives Erlebnis für Looker-Nutzer erstellen.
Explore-Name und -Menü
In diesem Abschnitt wird das Standardverhalten für den Namen und die Darstellung im Menü Erkunden beschrieben. Außerdem werden die LookML-Parameter beschrieben, mit denen Sie dieses Verhalten ändern können:
Standardverhalten des Menüs „Explore“
Modellnamen
Standardmäßig ist das Menü Entdecken nach Modellnamen sortiert, die durch den Namen der einzelnen Modelldateien bestimmt werden. Das Menü Entdecken enthält eine formatierte Version des Modellnamens. Unterstriche werden in Leerzeichen umgewandelt und alle Wörter werden großgeschrieben. Unter dem jeweiligen Modellnamen befindet sich eine Liste der in dieser Modelldatei definierten Explores.
Explore-Namen
Der Name der einzelnen Explore-Menüs 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. Die Explore-Namen werden außerdem als Explore-Titel über dem Field Picker angezeigt.
Im folgenden Beispiel ist order_items-Explorative Datenanalyse 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 explorative Analysetool order_items wird im Menü „Erkunden“ und in der Feldauswahl als Artikel auflisten angezeigt.
| Menü „Explore“: | Feldauswahl: |
 |
 |
Weitere Informationen zu Modelldateien finden Sie auf der Dokumentationsseite zu Modell- und Dateidateien. Weitere Informationen zum Definieren von Explores finden Sie auf der Parameterdokumentationsseite für explore.
label (Modell)
Mit dem Parameter label wird ein Modell im Menü Entdecken umbenannt, ohne dass sich die Verweis-URL 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ü „Erkunden“ als Marktforschung angezeigt.
Mit dem Parameter label können Sie das Modell im Menü „Erkunden“ umbenennen. Fügen Sie beispielsweise den Code label: "Marketing R&D" in die Modelldatei market_research.model ein:
label: "Marketing R&D"
In diesem Beispiel wird der Modellname in Looker im Menü „Explore“ wie folgt angezeigt:
label (Erkunden)
Mit dem Parameter label wird die Option „Entdecken“ im Menü Erkunden und auf der Seite „Erkunden“ umbenannt, ohne dass in LookML auf sie verwiesen wird.
Wenn der Parameter label nicht verwendet wird, wird der Name „Erkunden“ gemäß seinem Standardverhalten angezeigt.
group_label (Erkunden)
Wenn Sie einen group_label-Parameter verwenden, wird die Standardorganisation des Menüs Erkunden geändert. Anstatt jede explorative Datenanalyse unter dem Namen des Modells aufzulisten, können Sie in group_label eine benutzerdefinierte Überschrift definieren, unter der ein oder mehrere Explores aufgeführt werden.
In diesem Beispiel sind die Tabs Kunden, Inventar, Bestellelemente und Nutzerdaten unter dem Gruppenlabel Online Store-Abfragen aufgeführt:
description (Erkunden)
Mit dem Parameter description können Sie der Benutzeroberfläche eine Beschreibung einer explorativen Datenanalyse 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 (Erkunden)
Wenn Sie den Parameter hidden in einem explorativen Analysetool verwenden, wird es im Menü Erkunden ausgeblendet. Standardmäßig ist hidden deaktiviert und das Symbol „Erkunden“ wird angezeigt. hidden blendet LookML nicht aus und verhindert nicht den Zugriff auf ein Explore über die URL. hidden ist keine Sicherheitsfunktion, sondern eine Präsentationsfunktion.
Wenn Sie beispielsweise den LookML-Code hidden: yes zum LookML für das explorative Analysetool inventory im folgenden Beispiel hinzufügen, wird das Menü Entdecken im Menü „Erkunden“ 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 wird das Standardverhalten der Feldauswahl beschrieben. Danach werden 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
Standardmäßig ist die Feldauswahl nach Überschriften organisiert, die den durch den LookML-view-Parameter angegebenen Ansichten entsprechen. Die Felder in jeder Ansicht sind in der Feldauswahl gruppiert. Die Art des Feldes (Dimension, Dimensionsgruppe, Messwert, Filterfeld und Parameterfeld) bestimmt, an welcher Stelle in der Ansicht das Feld angezeigt wird. Wenn der Parameter label nicht verwendet wird, um den Anzeigenamen zu ändern, wird in der Feldauswahl eine formatierte Version der LookML-Ansicht oder des Feldnamens angezeigt. Unterstriche werden in Leerzeichen geändert und jedes Wort wird großgeschrieben.
Im folgenden Beispiel wird in der Looker-Ansicht für accounts die Ansicht als Konten angezeigt. Dies ist die Standardeinstellung:
view: accounts {
sql_table_name: accounts ;;
}
Im folgenden Beispiel sehen Sie, wie die Namen von Dimensionen, Dimensionsgruppen und Messungen 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 werden in der Feldauswahl 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 angezeigt.
Wenn Sie den Namen eines Felds ändern, wird die Feldauswahl an den neuen Namen angepasst. 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 die Feldnamen in einem Modell ändern, aber einige Nutzer gemeinsam genutzte Datenlinks haben und Sie möchten, dass diese bereits vorhandenen URLs funktionieren.
view_label (Erkunden)
Mit dem Parameter view_label wird die Gruppe von Feldern aus der Basisansicht einer explorativen Datenanalyse in der Feldauswahl geändert. Der Bezug auf das Feld „Erkunden“ und die zugehörigen Felder in LookML wird dabei nicht geändert.
Wenn Sie beispielsweise eine Ansicht order_facts mit einer explorativen Datenanalyse namens order_items verknüpfen, können Sie mit dem Parameter view_label festlegen, dass das Label, das in Looker für die Ansicht order_facts in der Feldauswahl angezeigt wird, so aussieht:
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 als Aufträge und mehr in der Feldauswahl der Funktion Bestellte Elemente angezeigt.
view_label (Beitreten)
Mit dem Parameter view_label eines Joins können Sie Felder aus einer Ansicht unter dem Namen einer anderen Ansicht in der Feldauswahl gruppieren. Wenn Sie view_label nicht explizit einem Join hinzufügen, wird für view_label standardmäßig der Name des Joins verwendet.
Zum Beispiel verknüpfen Sie die Ansicht products mit der explorativen Datenanalyse 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 in der Feldauswahl unter dem Ansichtslabel Produkte gruppiert und getrennt von der Ansicht Produktfakten:
Mit dem Parameter view_label können Sie der verknüpften products-Ansicht ein Ansichtslabel hinzufügen. Beispiel:
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 in der Feldauswahl gruppiert:
label (ansehen)
Mit dem label-Parameter einer Ansicht wird geändert, wie die Ansicht in der Feldauswahl beschriftet wird, ohne dass auf sie in LookML verwiesen wird. Wenn nichts festgelegt wurde, wird der Name der Ansicht standardmäßig als Bezeichnung verwendet. Im Gegensatz zu view_label (Erkunden) und view_label (Join) wirkt sich dieser Parameter auf alle Explores aus, in denen die Ansicht verwendet wird.
Mit dem Parameter label können Sie beispielsweise ein Label für die Ansicht inventory_items angeben:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
In diesem Beispiel zeigt die Feldauswahl das Label Elemente im Inventar für die Ansicht inventory_items und nicht das Standardlabel Inventarelemente an.
description (Feld)
Sie können jedem Feld ein description hinzufügen. Wenn Sie für BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, werden in Looker automatisch Feldbeschreibungen mit den Beschreibungen aus Ihren BigQuery-Spaltenmetadaten ausgefüllt.
Der Benutzer kann diese Beschreibung an mehreren Stellen sehen. Die Beschreibung wird angezeigt, wenn der Nutzer in der Feldauswahl rechts neben dem Feldnamen das Informationssymbol auswählt.
Außerdem wird die Beschreibung von Looker auch angezeigt, wenn der Nutzer den Mauszeiger in einer Visualisierung der Tabelle oder eines Tabellendiagramms in einer explorativen Datenanalyse, einem Dashboard oder einem Look auf den Spaltennamen bewegt.
hidden (Feld)
Standardmäßig werden Felder, die in einer Ansicht angegeben sind, im Field Picker angezeigt. Der Parameter hidden des Felds blendet ein Feld in der Feldauswahl aus.
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 daher hidden als Möglichkeit, die Feldauswahl sauber und nicht als Sicherheitsmerkmal zu verwenden.
Wenn Sie beispielsweise den LookML-Code hidden: yes zur LookML für die Dimension product_id im folgenden Beispiel hinzufügen, wird die Dimension Product ID aus der Feldauswahl ausgeblendet:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (Feld)
Mit dem Parameter fields können Sie festlegen, welche Felder aus der Basisansicht und Joins einer explorativen Datenanalyse in der Feldauswahl angezeigt werden. Wenn Sie den Parameter fields nicht verwenden, werden in Looker alle Felder verfügbar gemacht.
Verwenden Sie zur Angabe der Felder, die Sie im Field Picker anzeigen möchten, eine kommagetrennte Feld- oder Satzliste. Wenn Sie die Felder, die ausgeblendet werden sollen, angeben möchten, verwenden Sie den Satz ALL_FIELDS* mit einer durch Kommas getrennten Liste der auszuschließenden Felder oder einem Bindestrich (-).
Mit dem folgenden LookML-Code können Sie beispielsweise nur eine Auswahl der Felder aus aircraft in der Feldauswahl anzeigen:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
In diesem Beispiel werden im explorativen Flugzeugflugzeug in der Feldauswahl nur die Dimensionen Flugzeugmodellcode, Flugzeugmotorcode, Stadt, Land und Postleitzahl sowie die Messung Anzahl angezeigt.
label (Feld)
Mit dem Parameter label eines Felds können Sie festlegen, wie ein Feldname in der Feldauswahl angezeigt wird, ohne dass er in LookML auf ihn verweist. Wenn nichts festgelegt wurde, wird der Name des Feldes standardmäßig als Bezeichnung verwendet.
Mit dem Parameter label können Sie beispielsweise ein Label für die Dimension cost festlegen:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel hat die Dimension Kosten in der Feldauswahl das Label Preis.
view_label (Feld)
Mit dem Parameter view_label eines Felds können Sie den Namen der Ansicht ändern, unter der das Feld in der Feldauswahl aufgeführt ist, ohne dass sich der Verweis in LookML ändert. Wenn nichts angegeben ist, wird das Feld unter der Bezeichnung für die Ansicht angezeigt, in der sie definiert wurde.
Mit dem Parameter view_label können Sie beispielsweise ein Ansichtslabel für die Dimension cost angeben:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel wird in Looker in der Feldauswahl unter dem Ansichtslabel Kosteninformationen die Dimension Kosten angezeigt.
group_label (Feld)
Mit dem Parameter group_label können Sie Felder in einer gemeinsamen Drop-down-Liste innerhalb einer Ansicht in der Feldauswahl kombinieren.
In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Versandort, 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. Im Beispiel oben für group_label (Feld) zeigt das Gruppenlabel bereits an, dass die Felder für den Versand gelten. In solchen Fällen können Sie jedem dieser gruppierten Felder den Parameter group_item_label hinzufügen, um die Darstellung unter dem Gruppenlabel zu ändern.
In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Stadt, Land und Bundesland:
