full_suggestions

Utilizzo

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
Gerarchia
view
Tipo di campo
full_suggestions
Tipi di campi possibili
Dimensione, gruppo di dimensioni, filtro, parametro

Accetta
Un valore booleano (sì o no)

Definizione

Quando un utente filtra un'esplorazione in un tipo di campo che supporta i suggerimenti, per impostazione predefinita Looker suggerisce i possibili valori per il campo (consulta la pagina di documentazione Modifica dei suggerimenti per i filtri per informazioni su come influire sui suggerimenti per i filtri). Per fornire suggerimenti per un campo filtro, Looker esegue una query sul database per recuperare un elenco di valori distinti per il campo. Looker in genere genera questi suggerimenti eseguendo una query come la seguente sul campo del filtro:

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

Il parametro full_suggestions controlla il modo in cui Looker esegue query sul database per fornire suggerimenti per i valori del campo nel filtro di un'esplorazione:

  • full_suggestions: no: Looker utilizzerà la query di suggerimento del filtro tipica e interrogherà solo la vista che contiene il campo del filtro.

  • full_suggestions: yes: Looker aggiungerà la logica dell'esplorazione alla query di suggerimento del filtro, il che significa che includerà tutti i join dell'esplorazione necessari per eseguire query sul campo del filtro e la logica dei parametri dell'esplorazione, inclusi i seguenti parametri:

Comportamento predefinito

Se il parametro full_suggestions non è specificato per un campo, Looker esegue query per i valori dei suggerimenti con il seguente comportamento:

  • Per le esplorazioni che utilizzano sql_always_where o access_filter oppure always_join, Looker utilizza per impostazione predefinita il comportamento full_suggestions: yes. Poiché i parametri access_filter, sql_always_where e always_join applicano vincoli alle query di esplorazione, questi stessi vincoli vengono applicati alle query di suggerimento dei filtri. Per ulteriori informazioni su come Looker fornisce suggerimenti per le esplorazioni con vincoli di query, consulta Considerazioni per le esplorazioni con sql_always_where o access_filter.
  • In caso contrario, Looker utilizza il comportamento predefinito di full_suggestions: no, eseguendo query solo sulla vista del campo filtro e senza includere la logica dell'esplorazione. L'impostazione full_suggestions: no rende i suggerimenti per i filtri più efficienti, poiché Looker esegue query su una singola tabella senza join, senza utilizzare la logica definita nell'esplorazione.

Esempio

Per chiedere a Looker di utilizzare la logica dell'esplorazione per eseguire query sul database quando fornisce suggerimenti per i filtri per una dimensione, aggiungi full_suggestions: yes alla definizione della dimensione:

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

Considerazioni per le esplorazioni con sql_always_where o access_filter

I parametri sql_always_where e access_filter vengono spesso utilizzati per controllare l'accesso ai dati. Ogni volta che sql_always_where o access_filter vengono utilizzati in un'esplorazione, Looker applica queste limitazioni ai suggerimenti per i filtri che fornisce per i tipi di campi che supportano i suggerimenti. Per impedire agli utenti di visualizzare un suggerimento di filtro che non li riguarda, Looker richiede che la logica di esplorazione (full_suggestions:yes) venga applicata ai suggerimenti per i valori del filtro nell'esplorazione. Pertanto, se un'esplorazione è definita con sql_always_where o access_filter, Looker non fornirà suggerimenti per un filtro su un campo definito con full_suggestions:no.

Se hai un'esplorazione con sql_always_where o access_filter e hai un campo che sai che non richiede la logica sql_always_where o access_filter, puoi ignorare il comportamento aggiungendo bypass_suggest_restrictions:yes alla definizione del campo. L'istruzione bypass_suggest_restrictions:yes chiede a Looker di fornire l'elenco completo dei suggerimenti per i valori del filtro.