set

Uso

view: name_view {
set: set_name {
campos: [campo, campo, ...]
}
}
Hierarquia
set
Tipos de campo possíveis
Dimensão, grupo de dimensões, campo de filtro, medida

Aceita
Uma lista de colchetes entre nomes de campo

Definição

Conjuntos podem ser úteis quando referenciados em outros parâmetros, como fields (para mesclagens) e drill_fields (para campos), que precisam de listas de campos.

Defina cada conjunto usando o parâmetro set. Um conjunto pode conter qualquer número de dimensões, medidas ou campos de filtro da visualização atual, incluindo as dimensões individuais geradas por um grupo de dimensões. Ele também pode conter campos de outras visualizações usando a sintaxe view_name.field_name.

No parâmetro set, adicione um parâmetro fields e liste os campos, como neste exemplo:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

Os conjuntos também podem conter outros conjuntos. Para diferenciar um nome de conjunto do nome de uma dimensão ou medida, adicione um caractere *. Exemplo:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

set: my_second_set {
  fields: [
    dimension_three,
    measure_two
  ]
}

set: my_third_set {
  fields: [
    my_first_set*,
    my_second_set*
  ]
}

O conjunto chamado my_third_set conterá estes campos:

  • dimension_one
  • another_view.dimension_two
  • measure_one
  • dimension_three
  • measure_two

Por fim, os campos podem ser excluídos usando o caractere -. Exemplo:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

set: my_second_set {
  fields: [
    dimension_three,
    measure_two
  ]
}

set: my_third_set {
  fields: [
    my_first_set*,
    my_second_set*
  ]
}

set: my_fourth_set {
  fields: [
    my_first_set*,
    -measure_one
  ]
}

O conjunto chamado my_fourth_set conterá estes campos:

  • dimension_one
  • another_view.dimension_two

Examples

Crie um conjunto com o nome financial_data

set: financial_data {
  fields: [
    subtotal,
    shipping,
    tax,
    total,
    cost,
    profit
  ]
}

Crie um conjunto com o nome basic_customer_data na visualização Customers que também faça referência à visualização Customer Facts:

set: basic_customer_data {
  fields: [
    name,
    address,
    status,
    customer_order_facts.lifetime_orders,
    customer_order_facts.lifetime_revenue
  ]
}

Desafios comuns

Os campos de outra visualização precisam estar associados à guia "Explorar" em que o set está sendo usado.

Se você quiser referenciar um campo em set proveniente de outra visualização, confira se essa visualização está associada ao Explorar em que o set está sendo usado. Por exemplo, isto não funcionará:

Arquivo de modelo

explore: orders { ... }

Ver arquivo

view: orders {
  set: customer_info {
    fields: [customer.name]
  }
}

Como customers não faz parte de orders, um campo de customers não pode ser referenciado no conjunto customer_info.

Adicionar campos de um dimension_group a um conjunto

Quando você quiser adicionar campos de um dimension_group a um conjunto, precisará adicionar cada dimensão de período individualmente. Por exemplo, considere este dimension_group:

dimension_group: created {
  type: time
  timeframes: [date, week, month]
  sql: ${TABLE}.created_at ;;
}

Não é possível adicionar a dimensão de dia, semana e mês a um conjunto como este:

set: created_timeframes {
  fields: [created]
}

Em vez disso, você precisará adicionar os períodos individualmente, desta forma:

set: created_timeframes {
  fields: [
    created_date,
    created_week,
    created_month
  ]
}