full_suggestions

Uso

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}

Hierarquia Visualizar arquivo 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, o Looker sugere valores possíveis para o campo por padrão. 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 banco de dados para recuperar uma lista de valores distintos para o campo. O Looker geralmente 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 full_suggestions controla como o Looker consulta o banco de dados para fornecer sugestões para os valores do campo no filtro de uma análise detalhada:

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

• full_suggestions: yes: o Looker adiciona a lógica de análise detalhada à consulta de sugestão de filtro, o que significa que ele inclui todas as junções da análise detalhada necessárias para consultar o campo do filtro, além da lógica dos parâmetros da análise detalhada, incluindo os seguintes parâmetros:

  • sql_always_where
  • access_filter
  • always_join
  • conditionally_filter
  Observações:

  • As sugestões apresentadas a um usuário para uma case dimensão não serão restritas quando a dimensão for definida com full_suggestions:yes. Qualquer opção incluída em um parâmetro case ficará visível para todos os usuários.
  • O parâmetro always_filter não é aplicado a consultas de sugestão de filtro.

Comportamento padrão

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

• Para análises detalhadas que usam sql_always_where ou 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 de análise detalhada, 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 fornece sugestões para análises detalhadas com restrições de consulta.
• Caso contrário, o Looker usa o comportamento full_suggestions: no por padrão, consultando apenas a visualização do campo de filtro e sem incluir nenhuma lógica da análise detalhada. A configuração full_suggestions: no torna as sugestões de filtro mais eficientes, já que o Looker consulta uma única tabela sem junções e sem usar nenhuma lógica definida na análise detalhada.

Exemplo

Para que o Looker use a lógica da análise detalhada para consultar o 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 detalhadas 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 impedir que os usuários vejam uma sugestão de filtro que não se aplica a eles, o Looker exige que a lógica de análise detalhada (full_suggestions:yes) seja aplicada às sugestões de valor de filtro na análise detalhada. Portanto, se uma análise detalhada for definida com sql_always_where ou access_filter, o Looker não vai fornecer sugestões para um 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, é possível substituir o comportamento adicionando bypass_suggest_restrictions:yes à definição do campo. A instrução bypass_suggest_restrictions:yes solicita que o Looker forneça a lista completa de sugestões de valor de filtro.