Sempre_filtro

Uso

explore: explore_name {
Always_filter: {
Filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
Hierarquia
explore
always_filter
Valor padrão
Nenhuma

Aceita
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.