view_label（結合の場合）

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

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

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

用途

explore: view_name {
  join: view_name_2 {
    view_label: "desired label"
  }
}
階層
explore
join
view_label
デフォルト値
結合の名前

許可
文字列

定義

view_label は、結合されたビューのフィールド グループがフィールド ピッカーでどのようにラベル付けされるかを変更します。view_label を使用すると、ビューのフィールドを別のビューの名前にグループ化できます。

view_label は、モデル化のために複数のビューを要するものの、これらの複数のビューがビジネスユーザーに対しては同一の主体を表す場合に使用できます。たとえば、order_facts と orders の 2 つの結合ビューがある order_items という Explore を考えてみましょう。モデリングの目的で、これらのビューに個別の名前を保持したい場合があります。ただし、UI で両方が [注文] として表示される方が、ユーザーにとってわかりやすい場合があります。

join に view_label を明示的に追加しない場合、view_label はデフォルトで結合の名前になります。

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

例

フィールド ピッカーで customer_facts ビューが Customer ビューの一部として表示されるようにします。

explore: customer {
  join: customer_facts {
    view_label: "Customer"
    sql_on: ${customer.id} = ${customer_facts.customer_id} ;;
  }
}

フィールド ピッカーで product_facts ビューが [Product Info] ビューの一部として表示されるようにします。

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

一般的な課題

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

join の view_label を変更すると、フィールド選択ツールのみが影響を受けます。LookML でのフィールドの参照方法は変更されません。

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

結合されたビューをフィールド ピッカーで別のビューと統合する場合は、view_label で使用されている大文字と小文字が正しいことを確認してください。大文字と小文字は、フィールドピッカーに表示されるビュー名と一致している必要があります。次に例を示します。

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

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

知っておくべきこと

結合されたビューのラベルを変更する方法はいくつかあります。

LookML には、結合されたビューの名前を変更する方法がいくつかあります。これらの方法はすべて、LookML の記述方法に異なる影響を与えます。view_label はすべてのユースケースに適しているわけではありません。

状況 適切な LookML
フィールド ピッカーと LookML の作成の両方で、基盤となるテーブルとは異なる名前をビューに付ける ビューの sql_table_name
結合されたビューの名前を、フィールド ピッカーでのみ、基盤となるビューとは異なる名前にする 結合の view_label
同じビューを Explore に複数回結合し、フィールド ピッカーと LookML の記述の両方で、各ケースに一意の名前を適用する 結合の from
同じビューで複数の異なるテーブルを記述できる場合は、使用するテーブルを選択する 結合の sql_table_name

view_label は Explore の結合されたビューに影響します

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