label（フィールド）

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

label は、モデルの一部として使用することもできます。詳しくは、label（モデル用）パラメータのドキュメントをご覧ください。

label は、Explore の一部として使用することもできます（label（Explore の場合）パラメータ ドキュメント ページを参照）。

label は、ビューの一部として使用することもできます。詳しくは、label（ビュー用）パラメータのドキュメントをご覧ください。

label は、ダッシュボードの基準線パラメータのドキュメント ページで説明されている基準線の一部として使用することもできます。

使用状況

ビュー: view_name {
dimension: field_name {
label: "目的のラベル名"
}
}
階層
view
フィールド タイプ
label
使用可能なフィールドタイプ
ディメンション、ディメンション グループ、メジャー、フィルタ、パラメータ

許可
文字列

定義

label を使用すると、フィールド ピッカーと Explore のデータテーブルでのフィールド名の表示方法を選択できるようになり、Explore の使い勝手が向上します。特に指定がない場合、ラベルにはデフォルトでフィールド名が適用されます。

ラベルは、Explore で項目に表示される名前にのみ影響し、LookML でのフィールドの参照には影響しません。ラベルを持つフィールドは、引き続き LookML ファイルの通常の ${view_name.field_name} 構文で参照されます。

label による Liquid 変数

label パラメータでは、Liquid 変数を使用できます。Liquid 変数を使用すると、モデルや Explore に関する情報、フィールドに適用されたフィルタ、ユーザー属性値などのデータにアクセスできます。Liquid 変数を使用すると、label 値を動的に変更できるため、フィールド ピッカーやデータのビジュアリゼーションでフィールドの外観を変更できます。

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

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

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

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

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

Liquid 変数と label を併用して動的ラベルを定義するその他の例については、こちらのヘルプセンター記事をご覧ください。

例

メジャーをフィールド ピッカーの [Customer Count Distinct] ではなく [Number of Customers] と表示します。

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

注意点

IDE でビュー内の重複ラベルが報告される

同じビュー内で重複するフィールド ラベルを回避するため、Looker IDE では LookML ビューファイル内の重複したフィールド ラベルの行番号別に情報アイコンが表示されます。情報アイコンの行番号にカーソルを合わせると、ビューにラベルのあるフィールドがすでに存在します。

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