sugestões (para campos)

Esta página se refere ao parâmetro suggestions, que faz parte de uma dimensão, um campo de filtro ou um parâmetro.

Também é possível usar suggestions como parte de uma visualização, conforme descrito na página de documentação do parâmetro suggestions (para visualizações).

Uso

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

Hierarquia Ver arquivo view Tipo de campo suggestions

Tipos de campo possíveis Dimensão, filtro, parâmetro Aceita Uma string ou uma lista de strings

Definição

Quando um usuário filtra uma análise detalhada em um tipo de campo que aceita sugestões, por padrão, o Looker sugere valores possíveis para o campo. Consulte Mudar as sugestões de filtro para saber como afetar as sugestões de filtro. Para fornecer sugestões para um campo de filtro, o Looker executa uma consulta no seu banco de dados para recuperar uma lista de valores distintos para o campo. Normalmente, o Looker gera essas sugestões executando uma consulta como esta no campo de filtro:

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

O parâmetro suggestion permite codificar a lista de valores sugeridos para uma dimensão, um campo de filtro ou um parâmetro que vai aparecer quando alguém usar esse campo para filtrar uma consulta.

Observação: embora o Looker armazene em cache até 1.000 resultados para essa consulta, apenas os 100 primeiros aparecem para o usuário como sugestões de filtro.

Se o campo estiver em uma tabela grande, essa consulta poderá ser muito lenta ou criar uma carga de banco de dados muito grande. Ao usar suggestions, você pode fixar no código uma lista de valores possíveis e melhorar a performance.

O parâmetro suggestions também é útil porque permite especificar uma lista mais limitada se você não quiser que determinados valores de um campo apareçam como sugestões.

Atenção: os valores de label do parâmetro case terão precedência sobre as sugestões apresentadas aos usuários do parâmetro suggestions.

Exemplos

Substitua as sugestões padrão da dimensão colors por uma lista fixada no código:

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}