Label (für Felder)

Dieser Abschnitt bezieht sich auf den Parameter label, der Teil eines Felds ist.

label kann auch als Teil eines Modells verwendet werden. Dies wird auf der Seite mit der Parameterdokumentation für label (für Modelle) beschrieben.

label kann auch als Teil eines explorativen Analysetools verwendet werden, wie auf der Dokumentationsseite zum Parameter label (für explorative Datenanalysen) beschrieben.

label kann auch als Teil einer Ansicht verwendet werden, wie auf der Dokumentationsseite zum Parameter label (für Ansichten) beschrieben.

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

Nutzung

view: view_name {
Dimension: Feldname {
Label: „gewünschter Labelname“
}
}

Hierarchie Datei ansehen view Feldtyp label

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

Definition

Mit label können Sie die Option „Erkunden“ noch nutzerfreundlicher gestalten, indem Sie festlegen, wie Feldnamen in der Feldauswahl und in der Datentabelle von „Erkunden“ angezeigt werden. Wenn nichts festgelegt wurde, wird der Name des Feldes standardmäßig als Bezeichnung verwendet.

Das Label wirkt sich nur auf den angezeigten Namen des Felds in einer explorativen Datenanalyse aus. Sie hat keinen Einfluss auf den Verweis auf das Feld in LookML. Felder mit Labels werden weiterhin mit der normalen ${view_name.field_name}-Syntax in Ihren LookML-Dateien referenziert.

Flüssigkeitsvariablen mit label

Sie können Liquid-Variablen mit dem Parameter label verwenden. Mit Flüssigkeitsvariablen haben Sie Zugriff auf Daten wie Informationen zu einem Modell oder zu einem explorativen Analysetool, auf ein Feld angewendete Filter und Werte für Nutzerattribute. Sie können Liquid-Variablen verwenden, um den Wert von label dynamisch zu ändern. Dadurch ändert sich die Darstellung des Felds in der Feldauswahl und in den Datenvisualisierungen.

Flüssigkeitsvariablen, die einen Wert basierend auf einem Filter zurückgeben (z. B. _filters) oder die die Ausführung einer Abfrage erfordern (z. B. in_query), ändern den Feldnamen in der Feldauswahl nicht. In diesen Fällen wird der Feldname nur in der resultierenden Visualisierung geändert.

Die Variable „Liquid“ {{ _user_attributes['name_of_attribute'] }} ersetzt beispielsweise die Variable „Liquid“ durch den Wert des angegebenen Nutzerattributs. Wenn ein Nutzer ein Nutzerattribut mit dem Namen name und dem Wert „John Smith“ hat, würde die folgende label-Syntax den Namen des Felds in der Feldauswahl zu John Smith ändern:

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

Im nächsten Beispiel verwendet die Dimension name die Liquid-Struktur {% dynamic if %} {% dynamic else %} {% dynamic endif %} mit der Liquid-Variable _user_attributes['name_of_attribute'], um ihren label-Wert in Abhängigkeit eines Unternehmens-Nutzerattributs zu ändern:

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

Weitere Beispiele für die Verwendung von label mit Liquid-Variablen finden Sie in diesem Hilfeartikel.

Beispiel

Geben Sie in der Feldauswahl als Anzahl der Kunden den Wert Einzeln an.

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

Wichtige Punkte

Die IDE meldet doppelte Labels in einer Ansicht

Damit keine doppelten Feldlabels in derselben Ansicht vorhanden sind, zeigt die Looker-IDE in der LookML-Ansichtsdatei ein Informationssymbol nach der Zeilennummer aller doppelten Feldlabels an. Wenn Sie den Mauszeiger auf das Informationssymbol neben der Zeilennummer bewegen, zeigt die Kurzinfo an, dass bereits ein Feld mit dem Label in der Ansicht vorhanden ist.

Die Looker-IDE zeigt dieselben Informationen in der Schnellhilfe an, wenn Sie in der IDE auf den Text der label-Anweisung klicken: