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 e una breve descrizione della sua 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 che corrispondono a ciò che l'utente inserisce. In una dashboard, se il filtro della dashboard filtra un campo che supporta i suggerimenti, Looker suggerisce anche le opzioni di filtro. Questi suggerimenti per i filtri vengono creati utilizzando una query SELECT DISTINCT sul campo, quindi i suggerimenti restituiranno solo i valori che corrispondono ai dati esistenti per quel campo:
Se riscontri comportamenti imprevisti e devi risolvere i problemi relativi ai suggerimenti per i filtri, consulta la pagina delle best practice per la risoluzione dei problemi comuni relativi ai suggerimenti per i filtri.
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:
type: time
, con i seguenti valoritimeframes
:
Valore del filtro type
che supporta i suggerimenti:
type: string
Valori del parametro type
che supportano i suggerimenti:
type: string
type: unquoted
Attivare o disattivare i suggerimenti per i filtri
Questa sezione descrive 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 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 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 consentono di impostare o limitare i valori mostrati nei suggerimenti per i filtri:
allowed_value
(campo)bypass_suggest_restrictions
(campo)case
(campo)full_suggestions
(campo)suggest_dimension
(campo) esuggest_explore
(campo)suggestions
(campo)
allowed_value
(campo)
allowed_value
funziona con il parametro LookML parameter
. Se uno sviluppatore Looker fornisce un campo solo con filtri 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 parametro secondario label
specifica le opzioni che l'utente vedrà nei suggerimenti per i filtri. Il sottoparametro value
contiene i valori 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 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 altrimenti 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 nelle righe consentite. Tuttavia, se hai la certezza che in un determinato campo non esistono valori possibili che rivelerebbero informazioni sensibili, puoi utilizzare bypass_suggest_restrictions
per ripristinare l'insieme completo di suggerimenti per i filtri.
case
(campo)
case
ti consente di raggruppare i risultati di una dimensione con la logica case. Ciò influisce sui suggerimenti per i filtri perché vengono visualizzati solo i valori definiti nell'istruzione case
come suggerimenti per i filtri 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 il modo in cui Looker esegue query sul 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 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, ad esempiosql_always_where
,access_filter
econditionally_filter
.
Consulta la pagina full_suggestions
per informazioni sul comportamento predefinito di Looker per fornire suggerimenti e per considerazioni per le 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 di database troppo grande. Puoi utilizzare suggest_dimension
per fare in modo che Looker esegua una query su 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 codificare in modo permanente un elenco di possibili valori di suggerimento per i filtri. Questo 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.
Suggerimenti per i filtri di memorizzazione nella cache
Questa sezione descrive il parametro suggest_persist_for
, che consente di configurare il periodo di tempo durante il quale i suggerimenti per i filtri vengono memorizzati nella cache.
Se vuoi ridurre il carico sul database e il numero di valori di dati per un campo è molto elevato, valuta la possibilità di utilizzare un parametro per disattivare i suggerimenti per i filtri per il campo. Se vuoi che vengano visualizzati i suggerimenti per i filtri, valuta la possibilità 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 per i filtri vengono memorizzati nella cache per sei ore, il che comporta la visualizzazione dello stesso elenco di suggerimenti per questo periodo di tempo. Il parametro suggest_persist_for
consente di modificare la durata della memorizzazione nella cache dei suggerimenti per i filtri.