Modifica dei suggerimenti per i filtri

Questa pagina fornisce una panoramica dei parametri LookML che influiscono sui suggerimenti per i filtri. In questa pagina sono elencati tutti i parametri con un link alla 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 le opzioni che corrispondono a quanto inserito dall'utente. In una dashboard, se il filtro della dashboard applica un filtro in base 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 comportamenti imprevisti e devi risolvere i problemi relativi ai suggerimenti per i filtri, consulta la pagina Best practice per la risoluzione dei problemi comuni relativi ai suggerimenti di filtri.

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 (visualizza)

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

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

suggestable (campo)

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

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

Filtra valori dei suggerimenti

Questa sezione descrive 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 di solo filtro parameter, è 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 sottoparametro label specifica le opzioni che l'utente vedrà nei suggerimenti del 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 visibili agli utenti, Looker limita anche i suggerimenti per i filtri 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. Questo influisce sui suggerimenti per i filtri, perché solo i valori definiti nell'istruzione case vengono mostrati come suggerimenti per i filtri per quella dimensione.

Una dimensione che utilizza case può essere utilizzata con i filtri collegati, se viene utilizzata nel filtro che sta aggiornando 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 il modo in cui Looker esegue query sul database al fine di 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 Esplora alla query di suggerimento del filtro, il che significa che Looker includerà tutti i join dell'esplorazione necessari per eseguire query sul campo del filtro e Looker includerà la logica dei parametri dell'esplorazione, come 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 di solito 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 di 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.

Suggerimenti per i filtri nella cache

In questa sezione viene descritto il parametro suggest_persist_for, che consente di configurare il periodo di tempo in cui i suggerimenti per i filtri vengono memorizzati nella cache.

Se vuoi ridurre il carico sul database e il numero di valori dei dati per un campo è molto elevato, valuta la possibilità di utilizzare un parametro per disattivare i suggerimenti per i filtri per il tuo campo. Se vuoi che vengano visualizzati i suggerimenti per i filtri, ti consigliamo di 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, generando lo stesso elenco di suggerimenti per quel periodo di tempo. Il parametro suggest_persist_for ti consente di modificare per quanto tempo vengono memorizzati nella cache i suggerimenti per i filtri.