always_filter

Uso

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}

Hierarquia Arquivo de modelo explore always_filter

Valor padrão Nenhum Aceita Um nome de campo e uma expressão de filtro do Looker

Definição

O parâmetro always_filter permite exigir que os usuários incluam um conjunto de filtros em uma análise detalhada. Depois de definir os filtros e os valores padrão usando o parâmetro always_filter, a Análise vai mostrar automaticamente as configurações de filtro definidas.

Os filtros especificados no parâmetro always_filter não podem ser removidos da análise detalhada. No entanto, os usuários podem modificar o filtro mudando os valores ou a condição dele no menu suspenso. Os usuários também podem remover todos os valores do filtro, o que tem o mesmo efeito de remover o filtro.

Se você quiser que uma Análise tenha filtros que não podem ser modificados ou removidos, use um dos seguintes parâmetros:

• Para configurar filtros iguais para todos e que não podem ser vistos ou alterados de forma alguma, use o sql_always_where.
• Para configurar filtros específicos para cada usuário que não podem ser vistos nem alterados de forma alguma, use access_filter.

No parâmetro always_filter, 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 faz parte de uma visualização unida em vez desta Análise, 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 se refere ao campo id de customer. Este exemplo também demonstra que é possível adicionar vários filtros.

Para cada par field_name: "filter expression", a expressão de filtro pode ser um valor absoluto ou você pode usar expressões de filtro do Looker, dependendo do tipo de campo que você está filtrando.

Exemplos

Configure um filtro padrão para a análise no campo ID do pedido (com um valor padrão de "123"):

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

Configure um filtro padrão para a análise no campo Data de criação do pedido (com um valor padrão dos sete dias anteriores):

explore: order {
  always_filter: {
    filters: [created_date: "7 days"]
  }
}

Configure um filtro padrão para a análise no campo ID do pedido (valor padrão "123"), no campo Cidade do pedido (valor padrão "Chicago") e no campo 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} ;;
  }
}

Informações importantes

Os usuários não podem remover um filtro especificado por always_filter

Embora os usuários possam mudar a condição ou o valor padrão da consulta, eles não podem remover um filtro adicionado pelo always_filter. Se você quiser pré-carregar filtros para uma análise detalhada de forma que os usuários possam remover completamente os filtros, crie uma consulta que inclua filtros sugeridos e compartilhe a consulta com os usuários para que eles possam usar a consulta e os filtros como ponto de partida.

Definir um valor padrão em branco

Se quiser criar um filtro padrão 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.

O parâmetro always_filter substitui a configuração default_value do campo. Se você declarar um valor com always_filter, ele será o padrão na análise detalhada. Se você não declarar um valor com always_filter, "é qualquer valor" será o padrão do filtro na análise detalhada.

always_filter afeta os Looks e blocos de painel atuais

Adicionar o parâmetro always_filter a uma definição explore atual inclui o conjunto de filtros com os valores padrão em qualquer painel, análise detalhada ou bloco do painel com base nesse explore, incluindo painéis e análises detalhadas salvas anteriormente com base no explore.