Uso
Always_filter: {
Filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
Hierarquia
always_filter |
Valor padrão
NenhumaAceita
Um nome de campo e uma expressão de filtro do Looker
|
Definição
always_filter
permite que você exija que os usuários incluam um determinado conjunto de filtros definidos por você. Você também define um valor padrão para os filtros. Os usuários podem mudar o valor padrão das consultas, mas não podem remover o filtro por completo.
O campo referenciado no subparâmetro filters
pode ser uma dimensão, uma medida, um filtro ou um parâmetro. Se você precisar fazer referência a uma dimensão ou medida que faça parte de uma visualização mesclada em vez de "Explorar", use view_name.field_name
. Exemplo:
explore: order {
always_filter: {
filters: [id: "123", customer.id: "789"]
}
join: customer {
sql_on: ${order.customer_id} = ${customer.id} ;;
}
}
Aqui o filtro id
se refere ao campo id
de order
. O filtro customer.id
refere-se ao campo id
do customer
. Esse exemplo também demonstra que é possível exigir vários filtros.
No subparâmetro value
, especifique valores padrão usando expressões de filtro do Looker.
Examples
Força o usuário a usar um filtro de ID do pedido (com um valor padrão de "123"):
explore: order {
always_filter: {
filters: [id: "123"]
}
}
Força o usuário a usar um filtro Data de criação do pedido (com um valor padrão dos sete dias anteriores):
explore: order {
always_filter: {
filters: [created_date: "7 days"]
}
}
Força o usuário a usar um filtro de ID do pedido (valor padrão de "123"), um filtro de Cidade do pedido (valor padrão de "Chicago") e um filtro de Idade do cliente (valor padrão maior ou igual a 18):
explore: order {
always_filter: {
filters: [id: "123", city: "Chicago", customer.age: ">=18"]
}
join: customer {
sql_on: ${order.customer_id} = ${customer.id} ;;
}
}
Desafios comuns
Os usuários não podem remover um filtro especificado por always_filter
A IU do Explore não permite que os usuários removam um filtro adicionado por always_filter
. Se você quiser pré-carregar filtros para uma exploração que permita aos usuários remover completamente os filtros, crie uma consulta que inclua os filtros sugeridos e compartilhe a consulta com os usuários para que eles possam usar a consulta e os filtros correspondentes como ponto de partida.
Definir um valor padrão em branco
Se você quiser criar um filtro obrigatório com um valor padrão em branco, especifique "-EMPTY"
nos valores do filtro:
always_filter: {
filters: [products.category: "-EMPTY"]
}
O parâmetro always_filter
substitui uma configuração de filtro default_value
.
always_filter
modifica a configuração do default_value
para o campo. Se você declarar um valor com always_filter
, ele vai ser o padrão em "Explorar". Se você não declarar um valor com always_filter
, "é qualquer valor" será o filtro padrão em "Explorar".
Informações úteis
always_filter
afeta a aparência atual e os blocos do painel de controle
A adição de always_filter
a uma definição de explore
existente adiciona o conjunto de filtros com os valores padrão a todos os blocos "Olhar", "Explorar" ou "Painel" com base nesse explore
, incluindo os visuais salvos anteriormente e os blocos do painel baseados no explore
.
Se você quiser filtros que não possam ser alterados pelos usuários, considere o sql_always_where
.
Se você quiser que uma exploração tenha filtros iguais para todos e que não possam ser alterados, use sql_always_where
.
Se você quiser filtros específicos dos usuários que não podem ser alterados, considere usar o access_filter
.
Se você quiser que uma exploração tenha filtros específicos para cada usuário e que não possam ser alterados, use access_filter
.