Label (für Felder)

In diesem Abschnitt wird auf den Parameter label verwiesen, der Teil eines Felds ist.

label kann auch als Teil eines Modells verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter label (für Modelle) beschrieben.

label kann auch als Teil eines Explores verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter label (für Explores) beschrieben.

label kann auch als Teil einer Ansicht verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter label (für Ansichten).

label kann auch als Teil einer Referenzlinie verwendet werden, wie auf der Dokumentationsseite Dashboard-Referenzlinienparameter beschrieben.

Nutzung

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}

Hierarchie Datei ansehen view Feldtyp label

Mögliche Feldtypen Dimension, Dimensionsgruppe, Messwert, Filter, Parameter Akzeptiert Ein String

Definition

Mit label können Sie die Benutzerfreundlichkeit von Explores verbessern, indem Sie festlegen, wie Feldnamen im Field Picker und in der Datentabelle eines Explores angezeigt werden. Wenn nichts festgelegt wurde, wird der Name des Feldes standardmäßig als Bezeichnung verwendet.

Hinweis :label wirkt sich nur darauf aus, wie die Namen von Feldern in Looker-Inhalten angezeigt werden. label hat keine Auswirkungen darauf, wie Sie in LookML auf das Feld verweisen, und ändert auch nicht den Wert in der Datenbank. Verwenden Sie die Syntax ${view_name.field_name} in Ihren LookML-Dateien, um auf Felder mit Labels zu verweisen.

Liquid-Variablen mit label

Sie können Liquid-Variablen mit dem Parameter label verwenden. Mit Liquid-Variablen können Sie auf Daten wie Informationen zu einem Modell oder Explore, auf ein Feld angewendete Filter und Benutzerattribut-Werte zugreifen. Mit Liquid-Variablen können Sie den Wert von label dynamisch ändern und so die Darstellung des Felds in der Feldauswahl und in Datenvisualisierungen anpassen.

Liquid-Variablen, die einen Wert basierend auf einem Filter zurückgeben, z. B. _filters, oder für die zuerst eine Abfrage ausgeführt werden muss, z. B. in_query, ändern den Namen des Felds in der Feldauswahl nicht. In diesen Fällen wird der Feldname nur in der resultierenden Visualisierung geändert.

Die Liquid-Variable {{ _user_attributes['name_of_attribute'] }} ersetzt die Liquid-Variable beispielsweise durch den Wert des angegebenen Nutzerattributs. Wenn ein Nutzer ein Nutzerattribut namens name mit dem Wert „Max Mustermann“ hat, wird mit der folgenden label-Syntax der Name des Felds in der Feldauswahl in Max Mustermann geändert:

label: "{{ _user_attributes['name'] }}"

Im nächsten Beispiel wird für die Dimension name die Liquid-Struktur {% if %} {% else %} {% endif %} mit der Liquid-Variablen _user_attributes['name_of_attribute'] verwendet, um den label-Wert je nach Nutzerattribut company zu ändern:

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

Weitere Beispiele für die Verwendung von label mit Liquid-Variablen zum Definieren dynamischer Labels finden Sie auf der Seite Best Practices für die Verwendung von Liquid in Labels.

Beispiel

Dieser Messwert wird in der Feldauswahl als Anzahl der Kunden anstelle von Eindeutige Anzahl der Kunden angezeigt.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Wichtige Punkte

Die IDE kennzeichnet doppelte Labels in einer Ansicht.

Um doppelte Feldlabels in derselben Ansicht zu verhindern, wird in der Looker IDE neben der Zeilennummer aller doppelten Feldlabels in einer LookML-Ansichtsdatei ein Informationssymbol angezeigt. Wenn Sie den Mauszeiger auf das Informationssymbol neben der Zeilennummer bewegen, wird in der Kurzinfo angezeigt, dass in der Ansicht bereits ein Feld mit dem Label vorhanden ist.

In der Looker-IDE werden dieselben Informationen im Bereich Schnellhilfe angezeigt, wenn Sie den Text der label-Anweisung in der IDE auswählen: