Uso
set: set_name {
campos: [campo, campo, ...]
}
}
Hierarquia
set |
Tipos de campo possíveis
Dimensão, grupo de dimensões, campo de filtro, medidaAceita
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
]
}