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. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter für Referenzlinien.

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 den Namen user_data.model hat, wird im Menü „Explore“ standardmäßig der Dateiname verwendet, wobei Unterstriche durch Leerzeichen ersetzt werden und alle Wörter mit Großbuchstaben beginnen. Der Eintrag des Modells im Explore würde 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 erscheinen soll. Wenn Sie wissen, wie ein Modell für Ihre Nutzer aussehen soll, können Sie dies oft bei der Namensgebung berücksichtigen und so die Verwendung von label vermeiden.

Mit dem Parameter label können Sie die Formatierung eines Modellnamens ändern. So kann der Modellname „abc_info“ beispielsweise als „ABC Info“ statt als „Abc Info“ angezeigt werden.