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. Auf dieser Seite finden Sie eine Übersicht über LookML-Parameter, mit denen Sie die Darstellung des Looker-Menüs „Explore“ und der Feldauswahl ändern können.
| In Looker können die Nutzer die im Menü Explore aufgeführten Explores sehen. | In einem Explore können die Nutzer mit der Feldauswahl die Felder (Dimensionen und Measures) auswählen, die für die Abfrage 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 zur benutzerfreundlichen Gestaltung von Explores finden Sie auf der Seite Best Practice: Create a positive experience for Looker users.
Explore-Name und -Menü
In diesem Abschnitt wird das Standardverhalten für den Namen eines Explore und die Anzeige im Menü Explore erläutert. Anschließend werden die LookML-Parameter beschrieben, mit denen Sie dieses Verhalten ändern können:
Standardverhalten des Menüs „Explore“
Modellnamen
Standardmäßig ist das Menü Explore nach Modellnamen strukturiert, die vom Namen der verschiedenen Modelldateien abhängen. Das Menü Explore enthält eine formatierte Version des Modellnamens, wo Unterstriche in Leerzeichen umgewandelt werden und alle Wörter mit Großbuchstaben beginnen. Unter dem jeweiligen Modellnamen befindet sich eine Liste der in dieser Modelldatei definierten Explores.
Explore-Namen
Die Namen der einzelnen Explores im Menü beruhen 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 außerdem als Explore-Titel im Feldauswahl-Bereich 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 Menü „Explore“ und in der Feldauswahl als Order Items angezeigt.
| Menü „Explore“: | Feldauswahl: |
 |
 |
Weitere Informationen zu Modelldateien finden Sie auf der Dokumentationsseite Modelldateien und Ansichtsdateien. Weitere Informationen zum Definieren von Explores finden Sie auf der explore Dokumentationsseite zum Parameter.
label (Modell)
Mit dem Parameter label eines Modells wird der Name eines Modells im Menü Explore umbenannt, ohne den Verweis darauf in LookML zu ändern. Für Explore-URLs spiegeln die Looker-IDE und SQL Runner weiterhin den tatsächlichen Modellnamen wider. 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 Market Research angezeigt.
Mit dem Parameter label können Sie das Modell im Menü „Explore“ umbenennen. Fügen Sie beispielsweise 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 (Explore)
Mit dem Parameter label eines Explore wird das Explore im Menü Explore und auf der Seite „Explore“ umbenannt, ohne dass dadurch der Verweis darauf in LookML geändert wird.
Wenn der label Parameter nicht verwendet wird, wird der Explore-Name gemäß dem Standardverhalten angezeigt.
group_label (Explore)
Mit dem Parameter group_label eines Explore wird die Standardorganisation des Menüs Explore geändert. Anstatt jedes einzelne Explore unter dem dazugehörigen Modellnamen aufzuführen, können Sie mit group_label eine benutzerdefinierte Überschrift definieren, unter der ein oder mehrere Explores aufgelistet werden.
In diesem Beispiel werden die Explores Customers, Inventory, Order Items und User Data unter der Gruppenbezeichnung Online Store Queries aufgeführt:
description (Explore)
Mit dem Parameter description eines Explore können Sie der Benutzeroberfläche eine Beschreibung des Explores hinzufügen, damit die Nutzer beim Erstellen von Explore-Abfragen zusätzliche Informationen dazu erhalten.
Nutzer können die Beschreibung einblenden, indem sie den Mauszeiger auf das Informationssymbol verschieben, das sich oben in der Feldauswahl 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 (Explore)
Mit dem Parameter hidden eines Explore wird das Explore im Menü Explore ausgeblendet. Standardmäßig ist hidden deaktiviert und das Explore wird angezeigt. Mit hidden wird weder LookML ausgeblendet noch der Zugriff auf ein Explore über die URL verhindert. hidden ist nicht als Sicherheitsfunktion vorgesehen, sondern als Darstellungsfunktion.
Wenn Sie zum Beispiel den LookML-Code hidden: yes zum LookML für das Explore inventory hinzufügen, wird das 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} ;;
}
}
Feldauswahl
In diesem Abschnitt wird das Standardverhalten der Feldauswahl beschrieben. Anschließend werden die LookML-Parameter beschrieben, mit denen Sie dieses Verhalten ändern können.
Ändern Sie die Art und Weise, wie Ansichtsnamen in der Feldauswahl angezeigt werden:
Ändern Sie die Art und Weise, wie Namen einzelner Felder in der Feldauswahl angezeigt werden:
Ändern Sie die Art und Weise, wie Felder in der Feldauswahl organisiert werden:
Standardverhalten der Feldauswahl
Standardmäßig ist der Field Picker nach Überschriften organisiert, die den vom LookML-Parameter view festgelegten Ansichten entsprechen. Die Felder der verschiedenen Ansichten sind in der Feldauswahl zu Gruppen zusammengefasst. 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 zur Änderung des Anzeigenamens verwendet wird, zeigt die Feldauswahl eine formatierte Version der LookML-Ansicht oder des Feldnamens an, wobei Unterstriche in Leerzeichen umgewandelt werden und alle Wörter mit Großbuchstaben beginnen.
Im folgenden Beispiel wird die accounts Ansicht im Feldauswahl standardmäßig als Accounts angezeigt:
view: accounts {
sql_table_name: accounts ;;
}
Im folgenden Beispiel wird gezeigt, 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 werden in der Feldauswahl die Standardfeldnamen Account Number, Name, Created Date und Average Annual Revenue für die Dimensionen account_number und name, die Dimensionsgruppe created und den Messwert average_annual_revenue angezeigt.
Wenn Sie den Namen eines Feldes ändern, übernimmt der Field Picker den neuen Namen. Es kann jedoch sinnvoll sein, dem Feld den Parameter alias mit dem alten Namen des Feldes hinzuzufü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 haben Links zu Daten freigegeben und Sie möchten, dass diese URLs weiterhin funktionieren.
view_label (Explore)
Mit dem Parameter view_label eines Explore wird die Art der Bezeichnung der Gruppe von Feldern aus der Basisansicht eines Explore im Field Picker geändert. Dies hat keine Auswirkungen darauf, wie auf das Explore und die dazugehörigen 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 die Bezeichnung festlegen, die Looker für die Ansicht order_facts in der Feldauswahl 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 Feldauswahl des Explore Order Items als Orders and more angezeigt.
view_label (Join)
Mit dem Parameter view_label eines Joins können Sie in der Feldauswahl Felder aus einer Ansicht unter dem Namen einer anderen Ansicht gruppieren. Wenn Sie einem Join nicht ausdrücklich eine view_label hinzufügen, wird der Name des Joins standardmäßig als view_label verwendet.
Beispiel: Sie verknüpfen 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 keine Ansichtsbezeichnung angegeben ist, werden die Felder aus der Ansicht products im Field Picker unter der Ansichtsbezeichnung Products gruppiert, getrennt von der Ansicht Product Facts:
Mit dem Parameter view_label können Sie der verknüpften Ansicht products eine Ansichtsbezeichnung hinzufügen, wie im folgenden 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
}
}
Hiermit werden die Felder aus der Ansicht products in der Feldauswahl unter der Ansichtsbezeichnung Product Facts gruppiert.
label (Ansicht)
Mit dem Parameter label einer Ansicht wird die Art der Bezeichnung der Ansicht im Field Picker geändert. Dies hat keine Auswirkungen darauf, wie auf die Ansicht in LookML verwiesen wird. 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, die die Ansicht verwenden.
Beispiel: Sie können mit dem Parameter label eine Bezeichnung für die Ansicht inventory_items angeben:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
In diesem Beispiel wird in der Feldauswahl die Bezeichnung Items in Inventory für die Ansicht inventory_items angezeigt, und nicht die Standardbezeichnung Inventory Items.
description (Feld)
Sie können jedem Feld eine description hinzufügen. Wenn Sie bei BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, werden die Feldbeschreibungen in Looker automatisch mit den Beschreibungen aus den BigQuery-Spaltenmetadaten gefüllt, sofern vorhanden.
Der Nutzer kann diese Beschreibung an mehreren Stellen sehen. Looker zeigt die Beschreibung an, wenn der Nutzer das Informationssymbol rechts neben dem Feldnamen in der Feldauswahl auswählt.
Darüber hinaus zeigt Looker die Beschreibung auch an, wenn der Nutzer mit der Maus auf den Spaltennamen in einer Tabelle oder Tabellendiagramm-Visualisierung auf einer Explore-Seite, in einem Dashboard oder einem Look zeigt.
hidden (Feld)
Standardmäßig werden Felder, die in einer Ansicht angegeben sind, in der Feldauswahl angezeigt. Mit dem Parameter hidden des Feldes wird ein Feld in der Feldauswahl 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, die der Übersichtlichkeit der Feldauswahl dient, nicht der Sicherheit.
Wenn Sie zum Beispiel den LookML-Code hidden: yes zum LookML für die Dimension product_id hinzufügen, wird die Dimension Product ID in der Feldauswahl ausgeblendet:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (Feld)
Mit dem fields Parameter können Sie festlegen, welche Felder aus der Basisansicht eines Explore und Joins in der Feldauswahl angezeigt werden. Wenn Sie den Parameter fields nicht verwenden, zeigt Looker alle Felder an.
Verwenden Sie zur Angabe der Felder, die Sie in der Feldauswahl anzeigen möchten, eine durch Kommas getrennte Liste von Feldern oder Sätzen. Verwenden Sie zur Angabe der Felder, die Sie in der Feldauswahl ausblenden möchten, den Satz ALL_FIELDS* mit einer durch Kommas getrennten Liste der auszuschließenden Felder oder Sätze, wobei jedem Feld bzw. Satz ein Bindestrich (-) vorangestellt ist.
Sie können beispielsweise 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 Aircraft in der Feldauswahl nur die Dimensionen Aircraft Model Code, Aircraft Engine Code, City, Country und Zip sowie der Messwert Count angezeigt.
label (Feld)
Mit dem Parameter label eines Feldes können Sie ändern, wie ein Feldname in der Feldauswahl dargestellt wird, ohne dass sich dadurch der Verweis darauf in LookML ändert. Wenn nichts festgelegt wurde, wird der Name des Feldes standardmäßig als Bezeichnung verwendet.
Beispiel: Sie können mit dem Parameter label eine Bezeichnung für die Dimension cost festlegen:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel hat die Dimension Cost in der Feldauswahl die Bezeichnung price.
view_label (Feld)
Mit dem Parameter view_label eines Feldes können Sie den Namen der Ansicht ändern, unter der das Feld in der Feldauswahl aufgeführt ist, ohne dass sich dadurch der Verweis darauf in LookML ändert. Wenn nichts angegeben ist, wird das Feld unter der Bezeichnung für die Ansicht angezeigt, in der sie definiert wurde.
Beispiel: Sie können den Parameter view_label wie folgt verwenden, um eine Ansichtsbezeichnung für die Dimension cost anzugeben:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
In diesem Beispiel zeigt Looker die Dimension Cost unter der Ansichtsbezeichnung Cost Information in der Feldauswahl an.
group_label (Feld)
Mit dem group_label Parameter können Sie Felder in einer gemeinsamen Dropdown-Liste innerhalb einer Ansicht in der Feldauswahl kombinieren.
In diesem Beispiel enthält die Gruppe Shipping Info die Felder Shipping City, Shipping Country und Shipping State:
group_item_label (Feld)
Wenn Felder unter einer Gruppenbezeichnung angezeigt werden, müssen möglicherweise nicht die vollständigen Namen oder Bezeichnungen in der Feldauswahl erscheinen. Im vorstehenden Beispiel für group_label (Feld) gibt bereits die Gruppenbezeichnung an, dass die Felder zum Versand gehören. In solchen Fällen können Sie jedem dieser gruppierten Felder den Parameter group_item_label hinzufügen, um die Darstellung unter der Gruppenbezeichnung zu ändern.
In diesem Beispiel enthält die Gruppe Shipping Info die Felder City, Country und State:
