Modifica dei 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 pagina di riferimento completa, una breve descrizione della sua funzione e un'immagine della sua funzione.

Comportamento predefinito

Per impostazione predefinita, in un Look o un'esplorazione, quando un utente inserisce un valore di filtro per una dimensione di type: string, Looker suggerisce opzioni corrispondenti a ciò che l'utente inserisce. In una dashboard, se il filtro della dashboard applica un filtro in base a un campo di type: string, Looker suggerisce anche le opzioni di filtro. Questi suggerimenti per i filtri vengono creati utilizzando una query SELECT DISTINCT sulla dimensione, quindi restituiranno solo i valori che corrispondono ai dati esistenti per il campo in questione:

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

Se riscontri comportamenti imprevisti e hai bisogno di risolvere dei problemi relativi ai filtri suggeriti, consulta la pagina Best practice per la risoluzione dei problemi comuni relativi ai suggerimenti di filtri.

Attivare o disattivare i suggerimenti per i filtri

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

suggestable (campo)

Se imposti suggestable su no, puoi disattivare i suggerimenti per una dimensione o un filtro. Il valore predefinito di suggestable è yes, quindi Looker fornisce suggerimenti all'utente, se possibile. Se imposti suggestable su no, Looker non fornirà suggerimenti.

suggestions (visualizzazione)

Se imposti suggestions su no, puoi disattivare i suggerimenti per tutte le dimensioni di una vista. Il valore predefinito di suggestions è yes, quindi Looker fornisce suggerimenti all'utente, se possibile. Se imposti suggestions su no, Looker non fornirà suggerimenti.

Filtra valori suggerimento

In questa sezione vengono descritti i seguenti parametri LookML che consentono di impostare o limitare i valori mostrati nei suggerimenti per i filtri:

allowed_value (campo)

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

allowed_value ha due sottoparametri, label e value. Il sottoparametro label specifica le opzioni che l'utente vedrà nei suggerimenti per i filtri. Il sottoparametro value contiene i valori trasmessi 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"
  }
}

Quando un utente applica un filtro in base al 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 di parameter.

bypass_suggest_restrictions (campo)

bypass_suggest_restrictions attiva i suggerimenti per i filtri in situazioni in cui sarebbero disattivati o limitati. Se hai utilizzato sql_always_where o access_filter per limitare le righe che gli utenti possono visualizzare, Looker limita anche i suggerimenti per i filtri ai valori presenti nelle righe consentite. Tuttavia, se hai la certezza che in una determinata dimensione o campo di filtro non sono possibili valori che potrebbero rivelare informazioni sensibili, puoi utilizzare bypass_suggest_restrictions per ripristinare l'insieme completo dei suggerimenti per i filtri.

case (campo)

case consente di raggruppare i risultati di una dimensione con la logica delle maiuscole. Questo influisce sui suggerimenti per i filtri perché solo i valori definiti nell'istruzione case vengono mostrati come suggerimenti per i filtri per la dimensione in questione.

I suggerimenti presentati a un utente per una dimensione utilizzando case non saranno limitati durante l'utilizzo di full_suggestions. Qualsiasi opzione che includi in un parametro case sarà visibile a tutti gli utenti.

Una dimensione che utilizza case può essere utilizzata con i filtri collegati, se 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)

Se l'opzione full_suggestions è impostata su no, vengono disattivati i suggerimenti per i filtri per una dimensione.

I suggerimenti presentati a un utente per una dimensione utilizzando case non saranno limitati durante l'utilizzo di full_suggestions. Qualsiasi opzione che includi in un parametro case sarà visibile a tutti gli utenti.

suggest_dimension (campo) e suggest_explore (campo)

In genere Looker 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 rendere la query Looker una dimensione alternativa per i suggerimenti sui filtri, in combinazione con suggest_explore se la dimensione si trova in un'esplorazione diversa.

suggestions (campo)

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

Suggerimenti per i filtri di memorizzazione nella cache

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

Se vuoi ridurre il carico sul database e il numero di valori dei dati per una dimensione è molto elevato, valuta la possibilità di utilizzare un parametro per disattivare i suggerimenti sui filtri per la dimensione. Se vuoi che vengano visualizzati suggerimenti sui filtri, considera l'utilizzo di un parametro per limitare i valori dei filtri sottoposti a query o per impostare come hardcoded le opzioni appropriate.

suggest_persist_for (campo)

Per impostazione predefinita, i suggerimenti per i filtri vengono memorizzati nella cache per 6 ore, generando lo stesso elenco di suggerimenti per quel periodo di tempo. Il parametro suggest_persist_for consente di modificare per quanto tempo i suggerimenti per i filtri vengono memorizzati nella cache.