ラベル（フィールド用）

このセクションでは、フィールドの一部である label パラメータについて説明します。

label は、label（モデル用）パラメータのドキュメント ページで説明されているように、モデルの一部としても使用できます。

label は、label（Explore 用） パラメータのドキュメント ページで説明されているように、Explore の一部としても使用できます。

label は、label（ビューの場合）のパラメータ ドキュメント ページで説明されているように、ビューの一部としても使用できます。

label は、ダッシュボードのリファレンスライン パラメータのドキュメント ページで説明されているように、リファレンスラインの一部としても使用できます。

用途

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}
階層
view
フィールド タイプ
label
使用可能なフィールドタイプ
ディメンション、ディメンショングループ、メジャー、フィルタ、パラメータ

許可
文字列

定義

label を使用すると、Explore のフィールド選択ツールとデータ表にフィールド名を表示する方法を選択できるため、Explore の使いやすさが向上します。特に指定がない場合、ラベルにはデフォルトでフィールド名が適用されます。

label を使用した Liquid 変数

label パラメータで Liquid 変数を使用できます。Liquid 変数を使用すると、モデルや Explore に関する情報、フィールドに適用されたフィルタ、ユーザー属性の値などのデータにアクセスできます。Liquid 変数を使用すると、label の値を動的に変更して、フィールド選択ツールやデータ可視化でのフィールドの表示を変更できます。

_filters などのフィルタに基づいて値を返す Liquid 変数や、in_query などのクエリを最初に実行する必要がある Liquid 変数は、フィールド ピッカーのフィールド名を変更しません。このようなケースでは、フィールド名は結果のビジュアリゼーションでのみ変更されます。

たとえば、Liquid 変数 {{ _user_attributes['name_of_attribute'] }} は、Liquid 変数を指定したユーザー属性の値に置き換えます。ユーザーに値が「John Smith」の name というユーザー属性がある場合、次の label 構文を使用すると、フィールド選択ツールのフィールド名が John Smith に変更されます。

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

次の例では、name ディメンションは、_user_attributes['name_of_attribute'] Liquid 変数を含む Liquid {% if %} {% else %} {% endif %} 構造を使用して、会社ユーザー属性に応じて label 値を変更します。

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

label と Liquid 変数を使用して動的ラベルを定義するその他の例については、ラベルでの Liquid の面白い使い方のベスト プラクティス ページをご覧ください。

例

フィールド ピッカーで、このメジャーが [Customer Count Distinct] ではなく [# of Customers] として表示されるようにします。

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

注意点

IDE でビュー内の重複するラベルにフラグが立てられる

同じビューでフィールド ラベルが重複しないように、Looker IDE では、LookML ビューファイル内の重複するフィールド ラベルの行番号の横に情報アイコンが表示されます。行番号の横にある情報アイコンにカーソルを合わせると、ツールチップに、ビューにすでに同じラベルのフィールドがあることが示されます。

Looker IDE で label ステートメントのテキストを選択すると、Looker IDE の [クイックヘルプ] パネルに同じ情報が表示されます。