suggerimenti (per i campi)

Questa pagina si riferisce al parametro suggestions, che fa parte di una dimensione, di un campo filtro o di un parametro.

Puoi utilizzare suggestions anche nell'ambito di una vista, come spiegato nella pagina della documentazione dedicata al parametro suggestions (per le viste).

Utilizzo

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

Gerarchia File vista view Tipo di campo suggestions

Tipi di campi disponibili Dimensione, filtro, parametro Accetta Una stringa o un elenco di stringhe

Definizione

Quando un utente filtra un'esplorazione in base a un tipo di campo che supporta i suggerimenti, per impostazione predefinita Looker suggerisce i valori possibili per il campo (per informazioni su come influire sui suggerimenti per i filtri, consulta Modifica dei suggerimenti per i filtri). Per fornire suggerimenti per un campo filtro, Looker esegue una query sul database per recuperare un elenco di valori distinti per il campo. In genere, Looker genera questi suggerimenti eseguendo una query come la seguente sul campo filtro:

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

Il parametro suggestion consente di codificare in modo hardcoded l'elenco dei valori suggeriti per una dimensione, campo filtro o parametro che verrà visualizzato quando qualcuno utilizza quel campo per filtrare una query.

Nota: anche se Looker memorizza nella cache fino a 1000 risultati per questa query, all'utente vengono mostrati solo i primi 100 risultati come suggerimenti per i filtri.

Se il campo si trova in una tabella di grandi dimensioni, questa query può essere troppo lenta o creare un carico di database troppo elevato. Utilizzando suggestions, puoi codificare in modo hardcoded un elenco di valori possibili e migliorare le prestazioni.

Il parametro suggestions è utile anche perché ti consente di specificare un elenco più limitato se non vuoi che determinati valori di un campo vengano visualizzati come suggerimenti.

Attenzione: i valori label del parametro case avranno la precedenza sui suggerimenti presentati agli utenti dal parametro suggestions.

Esempi

Sostituisci i suggerimenti predefiniti per la dimensione colors con un elenco hardcoded:

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}