Como alterar as sugestões de filtro

Esta página fornece uma visão geral dos parâmetros do LookML que afetam as sugestões de filtro. Esta página lista cada parâmetro com um link para a página de referência completa, uma breve descrição da função e uma imagem do que faz.

Comportamento padrão

Por padrão, em um acesso ou uma exploração, quando um usuário insere um valor de filtro para uma dimensão de type: string, o Looker sugere opções que correspondam ao que o usuário digita. Em um painel, se o filtro estiver em um campo de type: string, o Looker também sugere opções de filtro. Essas sugestões de filtro são criadas usando uma consulta SELECT DISTINCT na dimensão. Assim, as sugestões só retornam valores correspondentes aos dados existentes desse campo:

As sugestões de filtro aparecem em um menu suspenso que é revelado quando um usuário seleciona o campo de valor do filtro.

Se você tiver algum comportamento inesperado e precisar resolver problemas de sugestões de filtro, consulte a página Solução de problemas comuns de sugestões de filtro.

Como ativar ou desativar as sugestões de filtro

Esta seção descreve os seguintes parâmetros do LookML que permitem ativar ou desativar as sugestões de filtro:

suggestable (campo)

Ao definir suggestable como no, você pode desativar as sugestões para uma dimensão ou um filtro. O valor padrão de suggestable é yes, então o Looker fornece sugestões ao usuário quando possível. Se você definir suggestable como no, o Looker não fará sugestões.

suggestions (visualizar)

Definir suggestions como no permite desativar sugestões para todas as dimensões em uma visualização. O valor padrão de suggestions é yes, então o Looker fornece sugestões ao usuário quando possível. Se você definir suggestions como no, o Looker não fará sugestões.

Filtrar valores de sugestão

Esta seção descreve os seguintes parâmetros do LookML que permitem definir ou restringir os valores mostrados nas sugestões de filtro:

allowed_value (campo)

allowed_value funciona com o parâmetro LookML parameter. Se um desenvolvedor do Looker fornecer um campo parameter somente com filtro, os valores inseridos ou selecionados pelos usuários poderão ser referenciados usando uma {% parameter %} variável Liquid. Opcionalmente, você pode usar allowed_value para definir uma lista de valores que um usuário pode escolher para esse campo de parâmetro.

allowed_value tem dois subparâmetros, label e value. O subparâmetro label especifica as opções que o usuário verá nas sugestões de filtro. O subparâmetro value contém os valores transmitidos à variável Liquid {% parameter %}.

Por exemplo, um parâmetro pode ser definido da seguinte maneira:

parameter: order_amount {
  type: string
  allowed_value: {
    label: "Less than $50"
    value:"< 50"
  }
  allowed_value: {
    label: "Between $50 and $100"
    value:"<= 100"
  }
  allowed_value: {
    label: "Over $100"
    value:"> 100"
  }
}

Assim, quando um usuário filtrar o parâmetro, ele poderá escolher entre as opções Menos de R $50, Entre R $50 e R $100 e Mais de R $100.

Para mais informações, consulte esta seção da página de referência do parameter.

bypass_suggest_restrictions (campo)

O bypass_suggest_restrictions permite sugestões de filtro quando elas estão desativadas ou limitadas. Se você tiver usado sql_always_where ou access_filter para restringir as linhas que os usuários podem ver, o Looker também restringirá as sugestões de filtro aos valores nas linhas permitidas. No entanto, se você tiver certeza de que não há valores possíveis em uma dimensão ou um campo de filtro que possam revelar informações confidenciais, use bypass_suggest_restrictions para restabelecer o conjunto completo de sugestões de filtro.

case (campo)

O case permite agrupar os resultados de uma dimensão com a lógica de casos. Isso afeta as sugestões de filtro porque apenas os valores definidos na instrução case são mostrados como sugestões de filtro para essa dimensão.

As sugestões apresentadas a um usuário para uma dimensão que usa case não serão restritas ao usar full_suggestions. Todas as opções incluídas em um parâmetro case ficarão visíveis para todos os usuários.

Uma dimensão que usa case pode ser usada com filtros vinculados se for usada no filtro que está atualizando o outro filtro. Uma dimensão que usa case não pode ser usada no filtro que está sendo atualizado.

full_suggestions (campo)

Quando full_suggestions é definido como no, as sugestões de filtro para uma dimensão são desativadas.

As sugestões apresentadas a um usuário para uma dimensão que usa case não serão restritas ao usar full_suggestions. Todas as opções incluídas em um parâmetro case ficarão visíveis para todos os usuários.

suggest_dimension (campo) e suggest_explore (campo)

O Looker normalmente gera sugestões de filtro executando uma consulta SELECT DISTINCT no campo de filtro. Para algumas tabelas grandes, essa consulta pode ser muito lenta ou criar uma carga de banco de dados muito grande. Você pode usar suggest_dimension para tornar a consulta do Looker uma dimensão alternativa para as sugestões de filtro, em combinação com suggest_explore, se essa dimensão estiver em uma exploração diferente.

suggestions (campo)

suggestions permite codificar uma lista de possíveis valores de sugestão de filtro. Isso pode ser útil se você não quiser que determinados valores de dados em um campo apareçam como sugestões e, em vez disso, quiser especificar uma lista mais limitada.

Sugestões de filtros de cache

Nesta seção, descrevemos o parâmetro suggest_persist_for, que permite configurar o período em que as sugestões de filtro são armazenadas em cache.

Se você quiser reduzir a carga no banco de dados e o número de valores de dados para uma dimensão for muito alto, considere o uso de um parâmetro para desativar as sugestões de filtro para sua dimensão. Se você quiser que as sugestões de filtro apareçam, considere usar um parâmetro para limitar os valores do filtro que são consultados ou para codificar as opções apropriadas.

suggest_persist_for (campo)

Por padrão, as sugestões de filtro são armazenadas em cache por seis horas, resultando na mesma lista de sugestões para esse período. O parâmetro suggest_persist_for permite alterar por quanto tempo as sugestões de filtro são armazenadas em cache.