set

Utilizzo

view: view_name {
   set: set_name {
      fields: [field, field, ]
   }
}
Gerarchia
set
Tipi di campi possibili
Dimensione, gruppo di dimensioni, campo filtro, misura

Accetta
Un elenco di nomi di campi racchiuso fra parentesi quadre

Definizione

Gli insiemi possono essere utili quando vengono utilizzati come riferimento in altri parametri, ad esempio fields (per i join) e drill_fields (per i campi), che richiedono elenchi di campi.

Definisci ogni insieme utilizzando il parametro set. Un insieme può contenere un numero qualsiasi di dimensioni, misure o campi di filtro della visualizzazione corrente, incluse le singole dimensioni generate da un gruppo di dimensioni. Può contenere anche campi di altre viste utilizzando la sintassi view_name.field_name.

All'interno del parametro set, aggiungi un parametro fields e poi elenca i campi, come in questo esempio:

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

I set possono contenere anche altri set. Per distinguere il nome di un insieme dal nome di una dimensione o di una misura, aggiungi il carattere *. Ad esempio:

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*
  ]
}

Il set denominato my_third_set conterrà i seguenti campi:

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

Infine, i campi possono essere esclusi utilizzando il carattere -. Ad esempio:

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

Il set denominato my_fourth_set conterrà i seguenti campi:

  • dimension_one
  • another_view.dimension_two

Esempi

Crea un set denominato financial_data

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

Crea un insieme denominato basic_customer_data nella visualizzazione Clienti che fa riferimento anche alla visualizzazione Fatti sugli ordini dei clienti:

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

Sfide comuni

I campi di un'altra vista devono essere uniti all'esplorazione in cui viene utilizzato set

Se vuoi fare riferimento a un campo in set proveniente da un'altra visualizzazione, devi assicurarti che la visualizzazione sia unita all'Esplorazione in cui viene utilizzato set. Ad esempio, questo non funzionerà:

File del modello

explore: orders { ... }

Visualizza file

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

Qui customers non è stato unito a orders, quindi non è possibile fare riferimento a un campo di customers nel set customer_info.

Aggiunta di campi da un dimension_group a un insieme

Quando vuoi aggiungere campi da un dimension_group a un insieme, devi aggiungere ogni dimensione del periodo di tempo singolarmente. Ad esempio, considera questo dimension_group:

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

Non puoi aggiungere la dimensione Giorno, Settimana e Mese a un insieme come questo:

set: created_timeframes {
  fields: [created]
}

Dovrai invece aggiungere i periodi di tempo singolarmente, in questo modo:

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