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
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, o Looker sugere valores possíveis para o campo por padrão. Consulte Como 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 banco de dados para recuperar uma lista de valores distintos para o campo. Normalmente, o Looker gera essas sugestões executando uma consulta como a seguinte 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 suggestions permite codificar a lista de valores sugeridos para uma dimensão, campo de filtro ou parâmetro que vai aparecer quando alguém usar esse campo para filtrar uma consulta.

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, é possível codificar uma lista de valores possíveis e melhorar o desempenho.

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.

Exemplos

Substitua as sugestões padrão da dimensão colors por uma lista codificada:

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