group_label（适用于字段）

本页面中提及的 group_label 参数是字段的一部分。

group_label 也可以用作探索的一部分，如 group_label（适用于探索）参数文档页面中所述。

用法

view: view_name {
  dimension: field_name {
    group_label: "desired label name"
  }
}

层次结构 查看文件 view 字段类型 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"
  }
}

在这种情况下，这些字段不会以未分组的形式显示，而是会合并到可展开的配送信息部分中。

您还可以使用 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" ;;
  }
}

在字段选择器中，Special Date Calculation 字段将显示在 Created Date 维度组中。

您必须至少有一个带有组标签的字段，才能在字段选择器中创建组。此外，您无法将维度和指标分组到同一组标签下，因为在任何给定视图中，所有维度始终与所有指标分开显示。

例如，以下代码会在名为 Engine Details 的组标签内创建一个名为 Engine Type 的字段：

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