group_label (pour les champs)

Cette page fait référence au paramètre group_label qui fait partie d'un champ.

group_label peut également être utilisé dans une exploration, comme décrit sur la page de documentation du paramètre group_label (pour les explorations).

Utilisation

view: view_name {
  dimension: field_name {
    group_label: "desired label name"
  }
}
Hiérarchie
view
Type de champ
group_label
Types de champs possibles
Dimension, groupe de dimensions, filtre, mesure

Acceptation
Chaîne

Définition

Le paramètre group_label vous permet de regrouper des champs dans des groupes personnalisés, au sein d'une vue donnée, dans le sélecteur de champs. Exemple :

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"
  }
}

Dans ce cas, au lieu d'apparaître non groupés, les champs sont combinés dans une section Informations de livraison que vous pouvez développer.

Vous pouvez également utiliser le paramètre group_item_label pour spécifier la façon dont les champs apparaissent dans le sélecteur de champs sous un libellé de groupe. Pour en savoir plus, consultez la page de documentation sur le paramètre group_item_label.

group_label interagit également de manière utile avec les groupes de dimensions, car un groupe de dimensions place automatiquement ses champs ensemble dans le sélecteur de champ. En utilisant group_label, vous pouvez ajouter des champs au groupe de dimensions. Exemple :

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" ;;
  }
}

Dans le sélecteur de champs, le champ Special Date Calculation apparaît dans le groupe de dimensions Created Date.

Pour créer un groupe dans le sélecteur de champ, vous devez disposer d'au moins un champ avec le libellé de groupe. De plus, vous ne pouvez pas regrouper des dimensions et des mesures sous le même libellé de groupe, car toutes les dimensions apparaissent toujours séparément de toutes les mesures dans une vue donnée.

Par exemple, le code suivant crée un champ nommé Engine Type dans un libellé de groupe nommé Engine Details :

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