Label (für Modelle)

Auf dieser Seite wird auf den label Parameter 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 zu den Parametern für Referenzlinien in Dashboards beschrieben.

Nutzung


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

Akzeptiert
Ein String

Definition

Mit label können Sie die Namen der Modelle festlegen, die im Menü „Explore“ angezeigt werden, und so Explores benutzerfreundlicher gestalten.

Wenn Sie einer Modelldefinition nicht ausdrücklich ein 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 Menü „Explore“ standardmäßig der Dateiname mit Großbuchstaben und Leerzeichen statt Unterstrichen verwendet. Der Eintrag des Modells im Explore wird also als User Data gerendert.

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

label: "Market Research"

Der Parameter label befindet sich auf der obersten 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 Market Research 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 das 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 auf das Modell zu verweisen.

Vermeiden Sie label nach Möglichkeit, indem Sie Modelle durchdacht benennen

Für ein Modell ist kein Parameter label erforderlich, wenn der Name bereits so angezeigt und formatiert wird, wie er für Ihre Nutzer im Menü „Explore“ zu sehen sein soll. Wenn Sie wissen, wie ein Modell für Ihre Nutzer angezeigt werden soll, können Sie dies oft bei der Benennung berücksichtigen, sodass Sie label nicht verwenden müssen.

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.