Modificare i suggerimenti per i filtri

Questa pagina fornisce una panoramica dei parametri LookML che influiscono sui suggerimenti di filtro. 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 le 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, pertanto restituiranno solo i valori corrispondenti ai dati esistenti per quel 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 e parameter.

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:

Attivare o disattivare i suggerimenti di filtro

Questa sezione descrive i seguenti parametri LookML che ti consentono di attivare o disattivare i suggerimenti di filtro:

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 per i filtri:

allowed_value (campo)

allowed_value funziona con il parametro LookML parameter. Se uno sviluppatore di Looker fornisce un campo solo con filtri parameter, è possibile fare riferimento ai valori inseriti o selezionati dagli utenti utilizzando una variabile Liquid {% parameter %}. Facoltativamente, 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 parametro secondario 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"
  }
}

Quando un utente applica un filtro in base al parametro, può scegliere tra le opzioni Meno di 50 €, Tra 50 e 100 € e Oltre 100 €.

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

bypass_suggest_restrictions (campo)

bypass_suggest_restrictions attiva i suggerimenti di filtro in situazioni in cui altrimenti sarebbero 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 sono presenti valori che potrebbero rivelare informazioni sensibili, puoi utilizzare bypass_suggest_restrictions per reintegrare l'intero insieme di suggerimenti per i filtri.

case (campo)

case ti consente di raggruppare i risultati di una dimensione con la logica delle caselle. 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à query solo sulla visualizzazione 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 la fornitura di suggerimenti e per le considerazioni relative alle esplorazioni con sql_always_where o access_filter.

suggest_dimension (campo) e suggest_explore (campo)

In genere, Looker genera suggerimenti per i filtri eseguendo una query SELECT DISTINCT sul campo filtro. Per alcune tabelle di grandi dimensioni, questa query può essere troppo lenta o creare un carico del database troppo elevato. Puoi utilizzare suggest_dimension per fare in modo che Looker esegua una query su una dimensione alternativa per i suggerimenti di filtro, 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 dei suggerimenti di filtro. Questa opzione può essere utile se non vuoi che determinati valori di dati in un campo vengano visualizzati come suggerimenti e vuoi invece 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, ti consigliamo di utilizzare un parametro per limitare i valori del filtro sottoposti a query o per codificare 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 la durata della memorizzazione nella cache dei suggerimenti di filtro.