Label (für Modelle)

Auf dieser Seite wird auf den Parameter label verwiesen, der Teil eines Modells ist.

label kann auch als Teil eines Explores verwendet werden, wie auf der Dokumentationsseite zum Parameter label (für Explores) 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 eines Felds verwendet werden, wie auf der Dokumentationsseite zum Parameter label (für Felder) beschrieben.

label kann auch als Teil einer Referenzlinie verwendet werden, wie auf der Dokumentationsseite Dashboard reference line parameters beschrieben.

Nutzung


label: "mylabel"
Hierarchie
label
Standardwert
Der Name der Modelldatei, in Großbuchstaben und mit Leerzeichen statt Unterstrichen

Akzeptiert
Ein String

Definition

Mit label können Sie die Benutzerfreundlichkeit von Explores verbessern, indem Sie die Modellnamen festlegen, die im Menü „Explore“ angezeigt werden.

Wenn Sie einer Modelldefinition nicht ausdrücklich eine label hinzufügen, wird der Name des Modells standardmäßig als Bezeichnung verwendet, allerdings anschaulich formatiert. Unterstriche werden in Leerzeichen geändert, und jedes Wort fängt mit einem Großbuchstaben an.

Beispiele

Wenn Ihre Modelldatei user_data.model heißt, wird im Explore-Menü standardmäßig der Dateiname in Großbuchstaben und mit Leerzeichen anstelle von Unterstrichen verwendet. Der Eintrag des Modells im Explore wird also als Nutzerdaten gerendert.

Mit dem Parameter label können Sie den Eintrag des Modells im Menü „Explore“ in Marktforschung ändern:

label: "Market Research"

Der Parameter label gehört auf die oberste Ebene der Modelldatei. Beispiel:

connection: "faa"
label: "Market Research"

include: "/views/states.view.lkml"
include: "/views/users.view.lkml"

explore: states {}
explore: users {}

In diesem Beispiel wird das Modell in Looker jetzt im Menü „Explore“ als Marktforschung angezeigt.

Wichtige Punkte

In den folgenden Abschnitten finden Sie Details zur Verwendung des Parameters label für Modelle:

label ändert den Modellnamen nicht überall

Wenn Sie die label eines Modells ändern, wirkt sich das auf das Menü „Explore“ und die Darstellung des Modells in Listen von Looks und Dashboards aus. Für Explore-URLs spiegeln die Looker-IDE und SQL Runner weiterhin den tatsächlichen Modellnamen wider. Daher sollten Sie weiterhin den Dateinamen des Modells verwenden, um in LookML und Admin-Einstellungen darauf zu verweisen.

Vermeiden Sie label nach Möglichkeit, indem Sie Modelle sorgfältig benennen.

Ein Modell benötigt keinen label-Parameter, wenn der Name bereits angezeigt wird und so formatiert ist, wie er im Menü „Explore“ für Ihre Nutzer zu sehen sein soll. Wenn Sie wissen, wie ein Modell für Ihre Nutzer aussehen soll, können Sie dies oft bei der Benennung berücksichtigen und so die Verwendung von label vermeiden.

Mit dem Parameter label können Sie die Formatierung eines Modellnamens ändern. Sie können beispielsweise festlegen, dass der Modellname „abc_info“ als „ABC Info“ statt als „Abc Info“ angezeigt wird.