Como mudar as sugestões de filtro

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

Comportamento padrão

Por padrão, em uma Análise ou uma Análise Exploratória, quando um usuário insere um valor de filtro para um campo que oferece sugestões, o Looker sugere opções que correspondem ao que o usuário insere. Em um painel, se o filtro estiver filtrando um campo que oferece sugestões, o Looker também vai sugerir opções de filtro. Essas sugestões de filtro são criadas usando uma consulta SELECT DISTINCT no campo. Portanto, as sugestões só vão retornar valores que correspondam aos dados existentes para esse campo:

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

Se você tiver um comportamento inesperado e precisar resolver problemas com as sugestões de filtro, consulte a página Práticas recomendadas para resolver problemas comuns de sugestões de filtro.

Tipos de campo que oferecem sugestões

O Looker oferece sugestões para os seguintes type valores para dimension, dimension_group, filter e parameter campos.

Valores de type de dimensão que oferecem sugestões:

Valor de type do grupo de dimensões que oferece sugestões:

Valor de type do filtro que oferece sugestões:

  • type: string

Valores de type do parâmetro que oferecem sugestões:

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:

suggestions (visualização)

Por padrão, quando um usuário filtra uma Análise Exploratória em um campo que oferece sugestões, o Looker sugere valores possíveis para o campo.

É possível definir uma visualização com suggestions:no para desativar as sugestões de todos os campos na visualização.

suggestable (campo)

Por padrão, quando um usuário filtra uma Análise Exploratória em um campo que oferece sugestões, o Looker sugere valores possíveis para o campo.

É possível definir um campo individual com suggestable:no para desativar as sugestões do campo.

Valores de sugestão de filtro

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 parameter do LookML. Se um desenvolvedor do Looker fornecer um parameter campo somente para filtros, os valores inseridos ou selecionados pelos usuários poderão ser referenciados usando uma variável do Liquid {% parameter %}. Opcionalmente, é possível 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 vai ver nas sugestões de filtro. O subparâmetro value contém os valores transmitidos para a variável líquida {% 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"
  }
}

Em seguida, quando um usuário filtra o parâmetro, ele pode escolher entre as opções Menos de US $50, Entre US $50 e US $100 e Mais de US $100.

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

bypass_suggest_restrictions (campo)

bypass_suggest_restrictions ativa as sugestões de filtro em situações em que elas seriam desativadas ou limitadas. Se você usou sql_always_where ou access_filter para restringir as linhas que os usuários podem ver, o Looker também restringe 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 um campo específico que revelem informações sensíveis, use bypass_suggest_restrictions para restabelecer o conjunto completo de sugestões de filtro.

case (campo)

case permite agrupar os resultados de uma dimensão com a lógica de caso. 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.

Uma dimensão que usa case pode ser usada com filtros vinculados, se a dimensão 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)

É possível definir um campo com o parâmetro full_suggestions para controlar como o Looker consulta seu banco de dados para fornecer sugestões para os valores do campo de um filtro:

  • full_suggestions: no: o Looker vai usar uma consulta básica de valores distintos e consultar apenas a visualização que contém o campo de filtro.
  • full_suggestions: yes: o Looker vai adicionar a lógica da Análise Exploratória à consulta de sugestão de filtro, o que significa que o Looker vai incluir qualquer uma das junções da Análise Exploratória necessárias para consultar o campo do filtro, e o Looker vai incluir a lógica dos parâmetros da Análise Exploratória, como sql_always_where, access_filter e conditionally_filter.

Consulte a página full_suggestions para informações sobre o comportamento padrão do Looker para fornecer sugestões e para considerações para Análises Exploratórias com sql_always_where ou access_filter.

suggest_dimension (campo) e suggest_explore (campo)

Normalmente, o Looker 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. É possível usar suggest_dimension para fazer com que o Looker consulte uma dimensão alternativa para sugestões de filtro, em combinação com suggest_explore, se essa dimensão estiver em uma Análise Exploratória diferente.

suggestions (campo)

suggestions permite codificar uma lista de valores de sugestão de filtro possíveis. 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, especificar uma lista mais limitada.

Como armazenar sugestões de filtro em cache

Esta seção descreve 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 um campo for muito alto, considere usar um parâmetro para desativar as sugestões de filtro do campo. Se você quiser que as sugestões de filtro apareçam, considere usar um parâmetro para limitar os valores de filtro consultados ou para codificar as opções adequadas.

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 durante esse período. O parâmetro suggest_persist_for permite mudar o tempo em que as sugestões de filtro são armazenadas em cache.