Nesta página, você terá uma visão geral dos parâmetros do LookML que afetam as sugestões de filtro. Cada 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 Explorar, quando um usuário insere um valor de filtro para uma dimensão de type: string
, o Looker sugere opções que correspondem ao que o usuário digita. Em um painel, se o filtro do painel estiver sendo filtrado em um campo de type: string
(e, no caso de painéis legados, se o filtro for do tipo campo), o Looker também sugerirá opções de filtro. Essas sugestões de filtro são criadas usando uma consulta SELECT DISTINCT na dimensão. Portanto, as sugestões só retornarão valores que correspondem aos dados existentes desse campo:
Ativar ou desativar as sugestões de filtros
Esta seção descreve os seguintes parâmetros LookML que permitem ativar ou desativar as sugestões de filtro:
suggestable
(campo)
Definir suggestable
como no
permite desativar as sugestões para uma dimensão ou filtro. O valor padrão de suggestable
é yes
, então o Looker oferece sugestões ao usuário quando possível. Se você definir suggestable
como no
, o Looker não fará sugestões.
suggestions
(visualização)
Definir suggestions
como no
permite desativar as sugestões para todas as dimensões em uma visualização. O valor padrão de suggestions
é yes
, então o Looker oferece 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 LookML que permitem definir ou restringir os valores exibidos nas sugestões de filtro:
allowed_value
(campo)bypass_suggest_restrictions
(campo)case
(campo)full_suggestions
(campo)suggest_dimension
(campo) esuggest_explore
(campo)suggestions
(campo)
allowed_value
(campo)
allowed_value
funciona com o parâmetro LookML do parameter
. Se um desenvolvedor do Looker fornecer um campo parameter
somente de filtro, os valores inseridos ou selecionados pelos usuários podem ser referenciados usando uma {% parameter %} variável líquida. Você também 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 que são transmitidos para a variável líquida {% parameter %}
.
Para mais informações, consulte esta seção da página de referência parameter
.
bypass_suggest_restrictions
(campo)
O bypass_suggest_restrictions
ativa as sugestões de filtros nas 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 de dimensão ou filtro específico que revelaria informações confidenciais, use bypass_suggest_restrictions
para restabelecer o conjunto completo de sugestões de filtro.
case
(campo)
Com o case
, é possível agrupar os resultados de uma dimensão com a lógica de casos. Isso afeta as sugestões de filtro porque somente os valores definidos na instrução case
são exibidos como sugestões de filtro para essa dimensão.
As sugestões apresentadas a um usuário para uma dimensão usando
case
não serão restritas quando estiver usandofull_suggestions
. Todas as opções incluídas em um parâmetrocase
ficarão visíveis para todos os usuários.
Uma dimensão que usa case
pode ser usada com filtros vinculados (também conhecidos como filtros atributos para painéis legados) 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)
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 usando
case
não serão restritas quando estiver usandofull_suggestions
. Todas as opções incluídas em um parâmetrocase
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. Em algumas tabelas grandes, essa consulta pode ser muito lenta ou criar uma carga de banco de dados muito grande. Você pode usar a 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 exploração diferente.
suggestions
(campo)
O 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 de um campo apareçam como sugestões e, em vez disso, quiser especificar uma lista mais limitada.
Sugestões de filtros de armazenamento em 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 é muito alto, considere usar um parâmetro para desativar as sugestões de filtro para sua dimensão. Se você quiser que as sugestões de filtro sejam exibidas, use um parâmetro para limitar os valores do filtro que são consultados ou 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, o que resulta na mesma lista de sugestões desse período. O parâmetro suggest_persist_for
permite mudar por quanto tempo as sugestões de filtro são armazenadas em cache.