このページでは、モデルの一部である
labelパラメータについて説明します。
labelは、label（Explore 用）パラメータのドキュメント ページで説明されているように、Explore の一部としても使用できます。
labelは、label（ビューの場合）パラメータのドキュメント ページで説明されているように、ビューの一部としても使用できます。
labelは、label（フィールド用）パラメータのドキュメント ページで説明されているように、フィールドの一部としても使用できます。
labelは、ダッシュボードのリファレンスライン パラメータのドキュメント ページで説明されているように、リファレンスラインの一部としても使用できます。
用途
label: "mylabel"
|
階層
label |
デフォルト値
モデル ファイルの名前（大文字で、アンダースコアの代わりにスペースを使用）
許可
文字列
|
定義
label を使用すると、Explore メニューに表示されるモデル名を設定できるため、Explore をより使いやすくすることができます。
モデル定義に label を明示的に追加しない場合、デフォルトで、モデルの名前が適切に書式設定されてラベルになります。アンダーバーはスペースに、各単語の最初の文字は大文字に変更されます。
例
モデルファイルの名前が user_data.model の場合、デフォルトでは、Explore メニューでファイル名が使用されます。ファイル名は、大文字で、アンダースコアの代わりにスペースが使用されます。そのため、Explore のモデルのエントリは [ユーザーデータ] としてレンダリングされます。
label パラメータを使用して、[Explore] メニューのモデルのエントリを「Market Research」に変更できます。
label: "Market Research"
label パラメータは、モデルファイルの最上位に配置されます。次に例を示します。
connection: "faa"
label: "Market Research"
include: "/views/states.view.lkml"
include: "/views/users.view.lkml"
explore: states {}
explore: users {}
この例では、モデルが [Explore] メニューに [Market Research] として表示されます。
知っておくべきこと
以降のセクションでは、モデルの label パラメータの使用について詳しく説明します。
label でモデル名がすべての場所で変更されない
モデルの label を変更すると、Explore メニューと、Look とダッシュボードのリストにモデルが表示される方法に影響します。このとき Explore URL、Looker IDE、SQL Runner に反映されるモデル名は実際のモデル名のままであり、LookML および管理者設定でのモデルの参照名も変更されません。したがって、LookML と管理者設定でモデルを参照する場合は、引き続きモデルのファイル名を使用する必要があります。
モデルに適切な名前を付けて、可能な限り label を回避する
名前がすでに表示されていて、Explore メニューでユーザーに表示させたい形式になっている場合は、モデルに label パラメータは必要ありません。モデルをユーザーにどのように表示するかを把握している場合は、モデルに名前を付けるときにこの点を考慮することで、label の使用を回避できます。
label パラメータを使用すると、モデル名の形式を変更できます。たとえば、モデル名「abc_info」を「Abc Info」ではなく「ABC Info」として表示できます。