Alterar sugestões de filtros

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

Comportamento predefinido

Por predefinição, num Look ou numa exploração, quando um utilizador introduz um valor de filtro para um campo que suporta sugestões, o Looker sugere opções que correspondem ao que o utilizador introduz. Num painel de controlo, se o filtro do painel de controlo estiver a filtrar um campo que suporta sugestões, o Looker também sugere opções de filtro. Estas sugestões de filtros são criadas através de uma consulta SELECT DISTINCT no campo, pelo que as sugestões apenas devolvem valores que correspondem aos dados existentes para esse campo:

As sugestões de filtros são apresentadas num menu pendente que é revelado quando um utilizador seleciona o campo de valor do filtro.

Se tiver um comportamento inesperado e precisar de resolver problemas de sugestões de filtros, consulte a página de práticas recomendadas Resolução de problemas comuns de sugestões de filtros.

Tipos de campos que suportam sugestões

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

Valores de dimensões type que suportam sugestões:

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

Valor type do filtro que suporta sugestões:

  • type: string

Valores dos parâmetros type que suportam sugestões:

Ativar ou desativar sugestões de filtros

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

suggestions (vista)

Por predefinição, quando um utilizador filtra uma análise detalhada num campo que suporta sugestões, o Looker sugere possíveis valores para o campo.

Pode definir uma vista com suggestions:no para desativar as sugestões para todos os campos na vista.

suggestable (campo)

Por predefinição, quando um utilizador filtra uma análise detalhada num campo que suporta sugestões, o Looker sugere possíveis valores para o campo.

Pode definir um campo individual com suggestable:no para desativar as sugestões para o campo.

Valores de sugestões de filtros

Esta secção descreve os seguintes parâmetros do LookML que lhe permitem definir ou restringir os valores apresentados nas sugestões de filtros:

allowed_value (campo)

allowed_value funciona com o parâmetro do LookML parameter. Se um programador do Looker fornecer um parameter campo apenas de filtro, os valores introduzidos ou selecionados pelos utilizadores podem ser referenciados através de uma variável Liquid {% parameter %}. Opcionalmente, pode usar allowed_value para definir uma lista de valores que um utilizador 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 utilizador vê nas sugestões de filtros. O subparâmetro value contém os valores que são transmitidos à variável {% parameter %} do Liquid.

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

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 utilizador filtra pelo parâmetro, pode escolher entre as opções Inferior a 50 €, Entre 50 € e 100 € e Superior a 100 €.

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

bypass_suggest_restrictions (campo)

bypass_suggest_restrictions ativa as sugestões de filtros em situações em que, de outra forma, estariam desativadas ou limitadas. Se tiver usado sql_always_where ou access_filter para restringir as linhas que os utilizadores podem ver, o Looker também restringe as sugestões de filtros aos valores nas linhas permitidas. No entanto, se tiver a certeza de que não existem valores possíveis num campo específico que revelem informações confidenciais, pode usar bypass_suggest_restrictions para repor o conjunto completo de sugestões de filtros.

case (campo)

case permite agrupar os resultados de uma dimensão com lógica de distinção entre maiúsculas e minúsculas. Isto afeta as sugestões de filtros, porque apenas os valores definidos na declaração case são apresentados como sugestões de filtros para essa dimensão.

Uma dimensão que usa case pode ser usada com filtros associados, se a dimensão for usada no filtro que está a atualizar o outro filtro. Não é possível usar uma dimensão que use case no filtro que está a ser atualizado.

full_suggestions (campo)

Pode definir um campo com o parâmetro full_suggestions para controlar a forma como o Looker consulta a sua base de dados para fornecer sugestões para os valores do campo para um filtro:

  • full_suggestions: no: o Looker usa uma consulta básica de valores distintos e consulta apenas a vista que contém o campo de filtro.
  • full_suggestions: yes: o Looker adiciona a lógica de exploração à respetiva consulta de sugestão de filtro, o que significa que o Looker inclui qualquer uma das associações da exploração necessárias para consultar o campo do filtro, e o Looker inclui a lógica dos parâmetros da exploração, como sql_always_where, access_filter e conditionally_filter.

Consulte a página full_suggestions para ver informações sobre o comportamento predefinido do Looker para fornecer sugestões e considerações para explorações com sql_always_where ou access_filter

suggest_dimension (campo) e suggest_explore (campo)

Normalmente, o Looker gera sugestões de filtros executando uma consulta SELECT DISTINCT no campo de filtro. Para algumas tabelas grandes, esta consulta pode ser demasiado lenta ou criar um carregamento da base de dados demasiado grande. Pode usar suggest_dimension para fazer com que o Looker consulte uma dimensão alternativa para sugestões de filtros, em combinação com suggest_explore se essa dimensão estiver num Explore diferente.

suggestions (campo)

suggestions permite-lhe codificar uma lista de possíveis valores de sugestões de filtros. Isto pode ser útil se não quiser que determinados valores de dados num campo apareçam como sugestões e, em alternativa, quiser especificar uma lista mais limitada.

Sugestões de filtros de colocação em cache

Esta secção descreve o parâmetro suggest_persist_for, que lhe permite configurar o período durante o qual as sugestões de filtros são colocadas em cache.

Se quiser reduzir a carga na sua base de dados e o número de valores de dados para um campo for muito elevado, pondere usar um parâmetro para desativar as sugestões de filtros para o seu campo. Se quiser que apareçam sugestões de filtros, pondere usar um parâmetro para limitar os valores de filtros consultados ou codificar as opções adequadas.

suggest_persist_for (campo)

Por predefinição, as sugestões de filtros são colocadas em cache durante seis horas, o que resulta na mesma lista de sugestões durante esse período. O parâmetro suggest_persist_for permite-lhe alterar o tempo durante o qual as sugestões de filtros são armazenadas em cache.