full_suggestions

Uso

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
Hierarquia
view
Tipo de campo
full_suggestions
Tipos de campo possíveis
Dimensão, grupo de dimensões, filtro, parâmetro

Aceita
Um booleano (sim ou não)

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 a página de documentação 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 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 full_suggestions controla como o Looker consulta seu banco de dados para fornecer sugestões de valores de campo no filtro de uma análise detalhada:

  • full_suggestions: no: o Looker vai usar a consulta de sugestão de filtro típica e consultar apenas a visualização que contém o campo de filtro.

  • full_suggestions: yes: o Looker adiciona a lógica da Análise à consulta de sugestão de filtro. Isso significa que o Looker inclui qualquer junção da Análise necessária para consultar o campo do filtro, além da lógica dos parâmetros da Análise, incluindo:

Comportamento padrão

Se o parâmetro full_suggestions não for especificado para um campo, o Looker vai consultar valores de sugestão com o seguinte comportamento:

  • Para análises detalhadas que usam sql_always_where, access_filter ou always_join, o Looker usa o comportamento full_suggestions: yes por padrão. Como os parâmetros access_filter, sql_always_where e always_join aplicam restrições às consultas do recurso Detalhar, essas mesmas restrições são aplicadas às consultas de sugestão de filtro. Consulte Considerações sobre análises detalhadas com sql_always_where ou access_filter para mais informações sobre como o Looker oferece sugestões de análises detalhadas com restrições de consulta.
  • Caso contrário, o Looker vai usar o comportamento padrão do full_suggestions: no, consultando apenas a visualização do campo de filtro e sem incluir nenhuma lógica da Análise. A configuração full_suggestions: no melhora o desempenho das sugestões de filtro, já que o Looker consulta uma única tabela sem junções e sem usar nenhuma lógica definida na análise.

Exemplo

Para solicitar que o Looker use a lógica da análise detalhada para consultar seu banco de dados ao fornecer sugestões de filtro para uma dimensão, adicione full_suggestions: yes à definição da dimensão:

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

Considerações sobre análises com sql_always_where ou access_filter

Os parâmetros sql_always_where e access_filter são usados com frequência para controlar o acesso aos dados. Sempre que sql_always_where ou access_filter são usados em uma análise detalhada, o Looker aplica essas restrições às sugestões de filtro que faz para tipos de campo que aceitam sugestões. Para evitar que os usuários vejam uma sugestão de filtro que não se aplica a eles, o Looker exige que a lógica da Análise (full_suggestions:yes) seja aplicada às sugestões de valores de filtro na Análise. Portanto, se uma análise detalhada for definida com sql_always_where ou access_filter, o Looker não vai fornecer sugestões de filtro em um campo definido com full_suggestions:no.

Se você tiver uma análise detalhada com sql_always_where ou access_filter e um campo que não exige a lógica sql_always_where ou access_filter, adicione bypass_suggest_restrictions:yes à definição do campo para substituir o comportamento. A instrução bypass_suggest_restrictions:yes solicita que o Looker forneça a lista completa de sugestões de valores de filtro.