Das Menü „Explore“ und den Field Picker ändern

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 erhalten Sie einen Überblick über LookML-Parameter, mit denen die Darstellung des Looker-Menüs „Explore“ und der Feldauswahl geändert wird.

In Looker können Ihre Nutzer Explores im Menü Explore anzeigen. In einem Explore können Nutzer mit der Feldauswahl die Felder (Dimensionen und Messungen) auswählen, die zur Abfrage ihrer Daten verwendet werden sollen.
Explores werden im Menü „Explore“ unter dem Namen des Modells aufgeführt, zu dem sie gehören. Der Field Picker in einem Explore zeigt eine erweiterbare Liste von Ansichten mit Feldern, die Sie Ihrer Abfrage hinzufügen können.

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 Explores finden Sie auf der Seite Best Practices: Ein positives Erlebnis für Looker-Nutzer.

Explore-Name und -Menü

In diesem Abschnitt werden das Standardverhalten für den Namen eines Explores und die Anzeige 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. Im Menü Expl. Datenanalyse wird eine formatierte Version des Modellnamens angezeigt, wobei Unterstriche in Leerzeichen geändert werden und jedes Wort mit Großbuchstaben beginnt. Unter dem jeweiligen Modellnamen befindet sich eine Liste der in dieser Modelldatei definierten Explores.

Explore-Namen

Der Name der einzelnen Explores 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 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 im Field Picker als Order Items (Bestellelemente) angezeigt.

Menü „Explore“: Field Picker:
Auftragselemente werden im Menü „Explore“ in der Liste der Explores angezeigt. Das Label Bestellelemente wird oben links im Feldauswahlbereich angezeigt.

Weitere Informationen zu Modelldateien finden Sie auf der Dokumentationsseite Informationen zu Modell- und Ansichtsdateien. Weitere Informationen zum Definieren von Explores finden Sie auf der Dokumentationsseite zum Parameter explore.

label (Modell)

Der Parameter label eines Modells benennt ein Modell im Menü Explore um, ohne dass seine Verweise in LookML geändert werden. 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 Market Research angezeigt.

Mit dem Parameter label können Sie das Modell im Menü „Explore“ 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:

Das Modell „Marktforschung“ hat im Menü „Erkunden“ das Label „Forschung und Entwicklung“.

label (Entdecken)

Der Parameter label eines Explores benennt ein Explore im Menü Explore und auf der Explore-Seite um, ohne dass seine Bezeichnung in LookML geändert wird.

Wenn der Parameter label nicht verwendet wird, wird der Name des Explores gemäß dem Standardverhalten angezeigt.

Ein Explore mit der Bezeichnung „Bestellelementinformationen“ im Menü „Explore“ und im Field Picker.

group_label (Entdecken)

Durch den Parameter group_label eines Explores wird die Standardorganisation im Menü Expl. Datenanalyse geändert. Anstatt jeden 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.

In diesem Beispiel werden die Explores Kunden, Inventar, Bestellartikel und Nutzerdaten unter dem Gruppenlabel Online Store-Anfragen aufgeführt:

Explores, die im Menü „Explore“ unter der Gruppenbezeichnung „Online Store-Abfragen“ aufgeführt sind.

description (Entdecken)

Mit dem Parameter description eines Explores können Sie der Benutzeroberfläche eine Beschreibung eines Explores 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ü Expl. Datenanalyse 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 den LookML-Code hidden: yes zu LookML für das Explore inventory im folgenden Beispiel 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} ;;
  }
}

Field Picker

In diesem Abschnitt werden das Standardverhalten des Field Pickers und 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 der Field Picker nach Überschriften organisiert, die den im LookML-Parameter view angegebenen Ansichten entsprechen. Die Felder der einzelnen Ansichten werden 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 werden und jedes Wort mit Großbuchstaben beginnt.

Im folgenden Beispiel zeigt Looker die accounts-Ansicht im Field Picker als Konten an. Dies ist das Standardverhalten:


view: accounts {
  sql_table_name: accounts ;;
}

Im folgenden Beispiel sehen Sie, wie die Namen von Dimensionen, Dimensionsgruppen und Messwerten 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 Account Number (Kontonummer), Name, Erstellungsdatum und Durchschnittlicher Jahresumsatz für die Dimensionen account_number und name sowie die Dimensionsgruppe created bzw. average_annual_revenue.

Wenn Sie den Namen eines Felds ändern, wird der Field Picker an den neuen Namen angepasst. Möglicherweise möchten Sie 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 freigegebene Links zu Daten haben und Sie diese URLs weiterhin verwenden möchten.

view_label (Entdecken)

Der Parameter view_label eines Explores ändert, wie die Gruppe von Feldern aus der Basisansicht eines Explores im Field Picker beschriftet wird, ohne dass die Verweise auf das Explore und seine Felder in LookML geändert werden.

Wenn Sie beispielsweise die 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 als Orders and more (Aufträge und weitere) im Field Picker des Explore Order Items (Bestellpositionen) angezeigt.

view_label (beitreten)

Mit dem Parameter view_label eines Joins können Sie im Field Picker Felder aus einer Ansicht unter dem Namen einer anderen Ansicht gruppieren. Wenn Sie einem Join nicht explizit eine view_label hinzufügen, wird standardmäßig der Name des Joins als view_label 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 unter der Ansicht Produkte gruppiert und getrennt von der Ansicht Produktdaten:

Die Felder aus der Produktansicht sind standardmäßig unter dem Label "Produktansicht" gruppiert.

Mit dem Parameter view_label können Sie der verknüpften Ansicht products 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 im Field Picker unter dem Ansichtslabel Product Facts gruppiert:

Die Felder aus der Ansicht „Produkt“ sind unter dem Label „Produktfakten“ gruppiert.

label (Ansicht)

Der Parameter label einer Ansicht ändert die Beschriftung der Ansicht im Field Picker, ohne dass die Verweise in LookML auf sie verweisen. 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.

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 der Field Picker für die Ansicht inventory_items das Label Artikel im Inventar 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, füllt Looker Feldbeschreibungen automatisch mit den Beschreibungen aus den Metadaten Ihrer BigQuery-Spalte, 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 den Mauszeiger auf den Spaltennamen in einer Tabelle oder Tabellendiagramm-Visualisierung in einem Explore, Dashboard oder Look bewegt.

hidden (Feld)

Standardmäßig werden Felder, die in einer Ansicht angegeben sind, im Field Picker angezeigt. Durch den 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 Möglichkeit, den Field Picker sauber zu halten, und nicht als Sicherheitsfunktion.

Wenn Sie beispielsweise den LookML-Code hidden: yes zu LookML für die Dimension product_id hinzufügen, wird im folgenden Beispiel 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 Explores und von Joins im Field Picker angezeigt werden. 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 Sets mit einem Bindestrich (-) vor jedem Element.

Beispielsweise 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 Flugzeug nur die Dimensionen Modellcode des Flugzeugs, Motorcode 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 dass seine Referenz in LookML geändert wird. 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 im Field Picker die Bezeichnung Preis.

view_label (Feld)

Mit dem Parameter view_label eines Felds können Sie den Namen der Ansicht ändern, in der das Feld im Field Picker aufgeführt ist, ohne dass seine Referenz in LookML geändert wird. 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 zeigt Looker die Dimension Kosten im Field Picker unter dem Ansichtslabel Kosteninformationen an.

group_label (Feld)

Mit dem Parameter group_label können Sie Felder in einer gemeinsamen Drop-down-Liste innerhalb einer Ansicht im Field Picker kombinieren.

In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Versandstadt, Versandland und Versandland:

Die Gruppe mit Versandinformationen im Field Picker eines Explores.

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) gibt das Gruppenlabel bereits an, dass sich die Felder auf den Versand beziehen. In solchen Fällen können Sie den Parameter group_item_label jedem dieser gruppierten Felder hinzufügen, um die Darstellung unter dem Gruppenlabel zu ändern.

In diesem Beispiel enthält die Gruppe Versandinformationen die Felder Ort, Land und Bundesland:

Die Gruppe mit Versandinformationen im Field Picker eines Explores.