Nesta página, você encontra uma visão geral dos parâmetros LookML que afetam as sugestões de filtro. Nesta página, listamos 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 ele faz.
Comportamento padrão
Por padrão, em um Look ou em uma Análise, 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 insere. Em um painel, se o filtro do painel estiver filtrando em um campo de type: string
, o Looker também vai 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 retornarão apenas valores que correspondam aos dados existentes para esse campo:
Se você notar um comportamento inesperado e precisar resolver as sugestões de filtro, consulte a página de práticas recomendadas Como solucionar problemas comuns de sugestão de filtro.
Ativar ou desativar as sugestões de filtro
Nesta seção, descrevemos os seguintes parâmetros do LookML que permitem ativar ou desativar as sugestões de filtro:
suggestable
(campo)
Quando você define suggestable
como no
, as sugestões para uma dimensão ou um filtro são desativadas. O valor padrão de suggestable
é yes
, então o Looker dá sugestões ao usuário quando possível. Se você definir suggestable
como no
, o Looker não vai fazer sugestões.
suggestions
(visualização)
Ao definir suggestions
como no
, você pode desativar as sugestões para todas as dimensões de uma vista. O valor padrão de suggestions
é yes
, então o Looker dá sugestões ao usuário quando possível. Se você definir suggestions
como no
, o Looker não vai fazer 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)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 parameter
do LookML. Se um desenvolvedor do Looker fornecer um campo somente filtro parameter
, os valores inseridos ou selecionados pelos usuários vão poder ser referenciados usando uma {% parameter %} variável líquida. 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 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 %}
.
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"
}
}
Então, quando o usuário filtrar o parâmetro, poderá escolher entre as opções Menos de US $50, Entre US $50 e US $100 e Mais de US $100.
Para saber mais, consulte esta seção da página de referência do parameter
.
bypass_suggest_restrictions
(campo)
O bypass_suggest_restrictions
ativa as sugestões de filtro quando elas ficariam desativadas ou limitadas. Se você tiver usado sql_always_where
ou access_filter
para restringir as linhas que os usuários podem acessar, o Looker também vai 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 campo de filtro específico que possa revelar 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 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 com
case
não serão restritas ao usarfull_suggestions
. Qualquer opção incluída em um parâmetrocase
ficará visível a todos os usuários.
Uma dimensão que usa case
poderá ser usada com filtros vinculados se for usada no filtro que está atualizando o outro. 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 com
case
não serão restritas ao usarfull_suggestions
. Qualquer opção incluída em um parâmetrocase
ficará visível a 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 do 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 sugestões de filtro, junto com suggest_explore
, se essa dimensão estiver em uma Análise 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 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 de uma dimensão for muito alto, use 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 de filtro 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, resultando na mesma lista de sugestões para esse período. O parâmetro suggest_persist_for
permite mudar por quanto tempo as sugestões de filtro são armazenadas em cache.