group_label(フィールド用)

このページでは、フィールドの一部である group_label パラメータについて説明します。

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

使用状況

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

許可
文字列

定義

group_label パラメータを使用すると、フィールド ピッカーで、特定のビュー内でフィールドをカスタム グループにまとめることができます。例:

view: accounts {
  dimension: shipping_city {
    sql: ${TABLE}.shipping_city ;;
    group_label: "Shipping Info"
  }
  dimension: shipping_state {
    sql: ${TABLE}.shipping_state ;;
    group_label: "Shipping Info"
  }
  dimension: shipping_street {
    sql: ${TABLE}.shipping_street ;;
    group_label: "Shipping Info"
  }
}

この場合は、フィールドがグループ化されずに表示される代わりに、展開可能な [Shipping Info] セクションにまとめられます。

group_item_label パラメータを使用して、グループラベルの下のフィールド選択ツールでフィールドをどのように表示するかを指定することもできます。詳しくは、group_item_label のドキュメントをご覧ください。

また、group_label を使用すると、ディメンション グループが自動的にフィールド選択ツールにフィールドを配置するため、ディメンション グループとのやり取りに役立ちます。group_label を使用すると、ディメンション グループにフィールドを追加できます。例:

view: accounts {
  dimension_group: created {
    type: time
    timeframes: [date, week, month]
    sql: ${TABLE}.created_date ;;
  }
  dimension: special_date_calculation {
    sql: QUARTER(${TABLE}.created_date)
    group_label: "Created Date" ;;
  }
}

次のようになります。

フィールド ピッカーでグループを作成するには、グループラベルを含むフィールドが少なくとも 1 つ必要です。また、すべてのディメンションが特定のビュー内のすべてのメジャーよりも常に表示されるため、ディメンションとメジャーを同じグループラベルの下にグループ化することはできません。

たとえば、フィールドが 1 つの場合:

dimension: engine_type {
    group_label: "Engine Details"
    type: string
    sql: ${TABLE}.engine_type ;;
  }

グループラベルは次のようになります。