group_label (para campos)

Esta página se refere ao parâmetro group_label que faz parte de um campo.

group_label também pode ser usado como parte de uma análise detalhada, conforme descrito na página de documentação do parâmetro group_label (para análises detalhadas).

Uso

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

Hierarquia Ver arquivo view Tipo de campo group_label

Tipos de campo possíveis Dimensão, grupo de dimensões, filtro, métrica Aceita Uma string

Definição

Com o parâmetro group_label, é possível combinar campos em grupos personalizados em uma determinada visualização no seletor de campos. Exemplo:

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

Nesse caso, em vez de aparecerem desagrupados, os campos são combinados em uma seção expansível Informações de frete.

Também é possível usar o parâmetro group_item_label para especificar como os campos aparecem no seletor de campos em um rótulo de grupo. Consulte a página de documentação do parâmetro group_item_label para mais detalhes.

O group_label também interage com grupos de dimensões de maneiras úteis, já que um grupo de dimensões coloca automaticamente os campos juntos no seletor de campos. Usando group_label, é possível adicionar outros campos ao grupo de dimensões. Exemplo:

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

No seletor de campos, o campo Special Date Calculation aparece no grupo de dimensões Created Date.

É necessário ter pelo menos um campo com o rótulo do grupo para criar um grupo no seletor de campos. Além disso, não é possível agrupar dimensões e métricas com o mesmo rótulo de grupo, porque todas as dimensões sempre aparecem separadas de todas as métricas em qualquer visualização.

Por exemplo, o código a seguir cria um campo chamado Engine Type dentro de um rótulo de grupo chamado Engine Details:

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