Modificare i suggerimenti per i filtri

Questa pagina fornisce una panoramica dei parametri LookML che influiscono sui suggerimenti per i filtri. Questa pagina elenca ogni parametro con un link alla relativa pagina di riferimento completa e una breve descrizione della relativa funzione.

Comportamento predefinito

Per impostazione predefinita, in un look o in un'esplorazione, quando un utente inserisce un valore di filtro per un campo che supporta i suggerimenti, Looker suggerisce opzioni corrispondenti a quanto inserito dall'utente. In una dashboard, se il filtro della dashboard applica un filtro a un campo che supporta i suggerimenti, Looker suggerisce anche le opzioni di filtro. Questi suggerimenti di filtro vengono creati utilizzando una query SELECT DISTINCT sul campo, quindi restituiranno solo i valori che corrispondono ai dati esistenti per il campo:

I suggerimenti per i filtri vengono visualizzati in un menu a discesa che viene visualizzato quando un utente seleziona il campo del valore del filtro.

Se riscontri un comportamento imprevisto e devi risolvere i problemi relativi ai suggerimenti di filtro, consulta la pagina Best practice Risoluzione dei problemi comuni relativi ai suggerimenti di filtro.

Tipi di campi che supportano i suggerimenti

Looker supporta i suggerimenti per i seguenti valori type per i campi dimension, dimension_group, filter eparameter.

Valori della dimensione type che supportano i suggerimenti:

Valore del gruppo di dimensioni type che supporta i suggerimenti:

Valore del filtro type che supporta i suggerimenti:

  • type: string

Valori del parametro type che supportano i suggerimenti:

Attivazione o disattivazione dei suggerimenti per i filtri

In questa sezione vengono descritti i seguenti parametri LookML che consentono di attivare o disattivare i suggerimenti per i filtri:

suggestions (visualizzazione)

Per impostazione predefinita, quando un utente filtra un'esplorazione in base a un campo che supporta i suggerimenti, Looker suggerisce i possibili valori per il campo.

Puoi definire una visualizzazione con suggestions:no per disattivare i suggerimenti per tutti i campi della visualizzazione.

suggestable (campo)

Per impostazione predefinita, quando un utente filtra un'esplorazione in base a un campo che supporta i suggerimenti, Looker suggerisce i possibili valori per il campo.

Puoi definire un singolo campo con suggestable:no per disattivare i suggerimenti per il campo.

Valori dei suggerimenti per i filtri

Questa sezione descrive i seguenti parametri LookML che ti consentono di impostare o limitare i valori visualizzati nei suggerimenti di filtro:

allowed_value (campo)

allowed_value funziona con il parametro LookML parameter. Se uno sviluppatore di Looker fornisce un parameter campo solo con filtri, è possibile fare riferimento ai valori inseriti o selezionati dagli utenti utilizzando una variabile Liquid {% parameter %}. Se vuoi, puoi utilizzare allowed_value per definire un elenco di valori che un utente può scegliere per il campo del parametro.

allowed_value ha due sottoparametri, label e value. Il parametro secondario label specifica le opzioni che l'utente vedrà nei suggerimenti di filtro. Il sottoparametro value contiene i valori che vengono passati alla variabile Liquid {% parameter %}.

Ad esempio, un parametro può essere definito come segue:

parameter: order_amount {
  type: string
  allowed_value: {
    label: "Less than $50"
    value:"< 50"
  }
  allowed_value: {
    label: "Between $50 and $100"
    value:"<= 100"
  }
  allowed_value: {
    label: "Over $100"
    value:"> 100"
  }
}

Poi, quando un utente filtra il parametro, può scegliere tra le opzioni Meno di 50 $, Tra 50 $e 100 $ e Più di 100 $.

Per ulteriori informazioni, consulta questa sezione della pagina di riferimento parameter.

bypass_suggest_restrictions (campo)

bypass_suggest_restrictions attiva i suggerimenti per i filtri nei casi in cui verrebbero altrimenti disattivati o limitati. Se hai utilizzato sql_always_where o access_filter per limitare le righe che gli utenti possono vedere, Looker limita anche i suggerimenti di filtro ai valori nelle righe consentite. Tuttavia, se hai la certezza che in un determinato campo non siano presenti valori che potrebbero rivelare informazioni sensibili, puoi utilizzare bypass_suggest_restrictions per reintegrare l'insieme completo dei suggerimenti per i filtri.

case (campo)

case consente di creare un bucket per i risultati di una dimensione in base alla logica delle richieste. Ciò influisce sui suggerimenti di filtro perché solo i valori definiti nell'istruzione case vengono visualizzati come suggerimenti di filtro per quella dimensione.

Una dimensione che utilizza case può essere utilizzata con i filtri collegati, se la dimensione viene utilizzata nel filtro che aggiorna l'altro filtro. Una dimensione che utilizza case non può essere utilizzata nel filtro in fase di aggiornamento.

full_suggestions (campo)

Puoi definire un campo con il parametro full_suggestions per controllare in che modo Looker esegue query sul tuo database per fornire suggerimenti per i valori del campo per un filtro:

  • full_suggestions: no: Looker utilizzerà una query di base di valori distinti e eseguirà la query solo sulla vista contenente il campo del filtro.
  • full_suggestions: yes: Looker aggiungerà la logica dell'esplorazione alla query di suggerimento del filtro, il che significa che includerà le unioni dell'esplorazione necessarie per eseguire query sul campo del filtro e la logica dei parametri dell'esplorazione, ad esempio sql_always_where, access_filter e conditionally_filter.

Consulta la pagina full_suggestions per informazioni sul comportamento predefinito di Looker per fornire suggerimenti e per le considerazioni per le esplorazioni con sql_always_where o access_filter.

suggest_dimension (campo) e suggest_explore (campo)

Looker in genere genera suggerimenti per i filtri eseguendo una query SELECT DISTINCT nel campo del filtro. Per alcune tabelle di grandi dimensioni, questa query può essere troppo lenta o creare un carico del database troppo grande. Puoi utilizzare suggest_dimension per impostare la query di Looker come una dimensione alternativa per i suggerimenti relativi ai filtri, in combinazione con suggest_explore se la dimensione si trova in un'esplorazione diversa.

suggestions (campo)

suggestions consente di impostare come hardcoded un elenco di possibili valori di suggerimenti per i filtri. Questo può essere utile se non vuoi che determinati valori dei dati in un campo vengano visualizzati come suggerimenti, ma vuoi specificare un elenco più limitato.

Memorizzazione nella cache dei suggerimenti per i filtri

Questa sezione descrive il parametro suggest_persist_for, che consente di configurare il periodo di tempo per cui i suggerimenti di filtro vengono memorizzati nella cache.

Se vuoi ridurre il carico sul database e il numero di valori di dati per un campo è molto elevato, ti consigliamo di utilizzare un parametro per disattivare i suggerimenti di filtro per il campo. Se vuoi che vengano visualizzati i suggerimenti per i filtri, puoi utilizzare un parametro per limitare i valori dei filtri su cui viene eseguita la query o per strutturare con hard-code le opzioni appropriate.

suggest_persist_for (campo)

Per impostazione predefinita, i suggerimenti dei filtri vengono memorizzati nella cache per sei ore, quindi per questo periodo di tempo viene visualizzato lo stesso elenco di suggerimenti. Il parametro suggest_persist_for ti consente di modificare per quanto tempo vengono memorizzati nella cache i suggerimenti per i filtri.