view_label（Explore の場合）

このページでは、Explore の一部である view_label パラメータについて説明します。

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

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

用途

explore: explore_name {
  view_label: "desired label for the view"
}
階層
explore
view_label
デフォルト値
Explore の名前

許可
文字列

定義

view_label は、Explore のベースビューのフィールド グループにフィールド ピッカーでラベルを付ける方法を変更します。

view_label は、ビュー名の前にアンダーバーを追加して、フィールドピッカーでアルファベット順にソートしたときにそのビューが先頭に来るようにするために使われることがあります。モデル化のために複数のビューを要するものの、ビジネスユーザーに関連するビューについては同一の主体を表すものとする場合にも使用できます。たとえば、LookML で customer として定義されたビューと customer_facts として定義されたビューがあり、モデリングのためにこれらの名前を維持したいとします。どちらもビジネスユーザーにとっては、Customerとして表示した方が適切かもしれません。

フィールドの名前自体を変更する場合は、label パラメータを使用します。

例

ビジネス ユーザーに customer_facts Explore が [Customers] ビューの一部として表示されるようにします。

explore: customer_facts {
  view_label: "Customers"
}

product_facts Explore が [Product Info] ビューの一部としてユーザーに表示されるようにします。

explore: product_facts {
  view_label: "Product Info"
}

注意点

view_label は、フィールド ピッカーの外観を変更する以外の効果はありません。

Explore の view_label を変更すると、フィールド ピッカーのみが影響を受けます。[Explore] メニューでの Explore の表示方法と、LookML でのフィールドの参照方法はいずれも変更されません。

view_label で複数のビューを組み合わせる場合は、大文字と小文字を正しく使用する

Explore のベースビューのフィールドをフィールド ピッカーで Explore の結合ビューのいずれかと統合する場合は、view_label で使用する大文字と小文字の区別が正しいことを確認する必要があります。使用する大文字と小文字は、フィールドピッカーに表示されるビュー名と一致している必要があります。例を見てみましょう

explore: product {
  view_label: "Product Info"
  join: product_info {
    sql_on: ${product.product_id} = ${product_info.product_id} ;;
  }
}

フィールド ピッカーでの product_info の表示は「Product Info」になります。各単語の最初の文字が大文字になり、アンダースコアはスペースに置き換えられます。そのため、view_label: 'product_info' ではなく view_label: 'Product Info' を使用しました。

フィールドの view_label は、Explore の view_label よりも優先されます。

Explore のフィールドに view_label がある場合、そのフィールドは Explore の view_label ではなく、その view_label の下に表示されます。Explore とディメンションの両方に view_label 値がある次の例を考えてみましょう。

モデルファイルで、Explore は view_label: "View Label on Explore" で定義されています。

explore: us_births {
  label: "US births"
  view_label: "View Label on Explore"
}

us_births.view ファイルでは、state ディメンションは view_label: "View Label on Field" で定義されています。


view: us_births {
  label: "US births"

  dimension: state {
    view_label: "View Label on Field"
    type: string
    sql: ${TABLE}.state ;;
  }

この場合、state ディメンションの view_label が Explore の view_label をオーバーライドするため、Explore では state ディメンションが [フィールドのビューラベル] view_label の下に表示されます。

view_label は Explore のベースビューに影響します

このパラメータは view_label（結合用）に似ていますが、結合されたビューではなく、Explore のベースビューに影響します。label（ビュー用）とは異なり、このパラメータは対象の Explore のベースビューにのみ影響します。