Puoi utilizzare una serie di parametri LookML per rendere le esplorazioni più intuitive modificando l'aspetto dei campi nell'interfaccia utente senza alterare il codice LookML sottostante. Questa pagina fornisce una panoramica dei parametri LookML che modificano l'aspetto del menu Esplora di Looker e del selettore di campi.
| In Looker, gli utenti possono visualizzare le esplorazioni elencate nel menu Esplora. | All'interno di un'esplorazione, gli utenti possono utilizzare il selettore di campi per selezionare i campi (dimensioni e misure) da utilizzare per eseguire query sui dati. |
|
|
Questa pagina elenca ogni parametro di uso comune con un link alla pagina di riferimento completa, una breve descrizione della sua funzione e un'immagine di ciò che fa.
Per suggerimenti e suggerimenti su come creare un'esplorazione intuitiva, consulta la pagina Best practice: crea un'esperienza positiva per gli utenti di Looker.
Nome e menu di Esplora
Questa sezione descrive il comportamento predefinito per il nome e l'aspetto di un'esplorazione nel menu Esplora, quindi descrive i parametri LookML che consentono di modificare questo comportamento:
Esplorare il comportamento predefinito del menu
Nomi dei modelli
Per impostazione predefinita, il menu Esplora è organizzato in base ai nomi dei modelli, che sono determinati dal nome di ogni file del modello. Il menu Esplora mostra una versione formattata del nome del modello, con i trattini bassi sostituiti da spazi e ogni parola in maiuscolo. Sotto il nome di ogni modello è riportato un elenco delle esplorazioni definite nel file del modello.
Nomi delle esplorazioni
Il nome di ogni esplorazione nel menu si basa sul parametro explore corrispondente nel file del modello. Come per i nomi dei modelli, i nomi delle esplorazioni vengono formattati nel menu in modo che i trattini bassi vengano sostituiti da spazi e ogni parola venga scritta con la lettera iniziale maiuscola. Il nome dell'esplorazione viene visualizzato anche come titolo dell'esplorazione nel riquadro del selettore campi.
Nell'esempio seguente, l'esplorazione order_items è definita nel file del modello e_commerce_model.model:
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
L'esplorazione order_items viene visualizzata come Articoli dell'ordine nel menu Esplora e nel selettore campi.
| Menu Esplora: | Selettore campi: |
 |
 |
Per ulteriori informazioni sui file del modello, consulta la pagina della documentazione Informazioni sui file del modello e della visualizzazione. Per ulteriori informazioni sulla definizione delle esplorazioni, consulta la pagina della documentazione del parametro explore.
label (modello)
Il parametro label di un modello rinomina un modello nel menu Esplora senza modificare il modo in cui viene fatto riferimento in LookML. Gli URL di Esplora, l'IDE di Looker e SQL Runner continuano a riflettere il nome effettivo del modello; il modo in cui il modello deve essere referenziato in LookML e nelle impostazioni di amministrazione rimane invariato.
Per impostazione predefinita, il modello market_research.model viene visualizzato come Ricerche di mercato nel menu Esplora.
Puoi utilizzare il parametro label per rinominare il modello nel menu Esplora. Ad esempio, aggiungi il codice label: "Marketing R&D" al file del modello market_research.model:
label: "Marketing R&D"
In questo esempio, Looker visualizza il nome del modello nel menu Esplora nel seguente modo:
label (Esplora)
Il parametro label di un'esplorazione rinomina un'esplorazione nel menu Esplora e nella pagina Esplora senza modificare il modo in cui viene fatto riferimento in LookML.
Se il parametro label non viene utilizzato, il nome dell'esplorazione viene visualizzato in base al comportamento predefinito.
group_label (Esplora)
Un parametro group_label di Esplora modifica l'organizzazione predefinita del menu Esplora. Anziché elencare ogni esplorazione sotto il nome del modello, group_label ti consente di definire un'intestazione personalizzata sotto la quale elencare una o più esplorazioni.
In questo esempio, le esplorazioni Clienti, Inventario, Articoli dell'ordine e Dati utente sono elencate nell'etichetta del gruppo Query negozio online:
description (Esplora)
Il parametro description di un'esplorazione ti consente di aggiungere una descrizione di un'esplorazione all'interfaccia utente, in modo che gli utenti possano ottenere informazioni aggiuntive durante la creazione di query di esplorazione.
Gli utenti possono visualizzare la descrizione passando il mouse sopra l'icona delle informazioni accanto al nome di Esplora nella parte superiore del selettore di campi. L'icona delle informazioni viene visualizzata anche nell'elenco a discesa delle esplorazioni. Se non aggiungi esplicitamente una descrizione a un'esplorazione, non viene visualizzata alcuna descrizione.
hidden (Esplora)
Il parametro hidden di un'esplorazione nasconde l'esplorazione dal menu Esplora. Per impostazione predefinita, hidden è disattivato e viene visualizzato Esplora. hidden non nasconde LookML né impedisce l'accesso a un'esplorazione tramite l'URL. hidden non è inteso come funzionalità di sicurezza, ma piuttosto come funzionalità di presentazione.
Ad esempio, l'aggiunta del codice LookML hidden: yes al codice LookML per l'esplorazione inventory nel seguente esempio nasconde l'esplorazione Inventario dal menu Esplora:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Selettore campi
Questa sezione descrive il comportamento predefinito del selettore di campi, quindi descrive i parametri LookML che consentono di modificare questo comportamento.
Modifica la modalità di visualizzazione dei nomi delle visualizzazioni nel selettore di campi con:
Modifica la modalità di visualizzazione dei nomi dei singoli campi nel selettore dei campi con:
Modifica l'organizzazione dei campi nel selettore di campi con:
Comportamento predefinito del selettore campi
Per impostazione predefinita, il selettore di campi è organizzato in base alle intestazioni che corrispondono alle visualizzazioni specificate dal parametro LookML view. I campi di ogni visualizzazione sono raggruppati nel selettore dei campi. Il tipo di campo (dimensione, gruppo di dimensioni, misura, campo filtro e campo parametro) determina la posizione in cui viene visualizzato il campo all'interno della visualizzazione. A meno che il parametro label non venga utilizzato per modificare il nome visualizzato, il selettore di campi mostrerà una versione formattata del nome della visualizzazione o del campo LookML, con i trattini bassi sostituiti da spazi e ogni parola in maiuscolo.
Nell'esempio seguente, Looker mostra la accounts visualizzazione come Account nel selettore campi, che è il comportamento predefinito:
view: accounts {
sql_table_name: accounts ;;
}
L'esempio seguente mostra come vengono visualizzati per impostazione predefinita i nomi di una dimensione, di un gruppo di dimensioni e di una misura. La stessa formattazione verrà applicata ai nomi di tutti i campi filtro e dei parametri.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
In questo esempio, il selettore campi mostra i nomi dei campi predefiniti Numero account, Nome, Data creazione e Entrate annue medie per le dimensioni account_number e name, il gruppo di dimensioni created e la misura average_annual_revenue, rispettivamente.
Se modifichi il nome di un campo, il selettore di campi si adatta al nuovo nome, ma potresti voler aggiungere un parametro alias con il vecchio nome del campo. Questo parametro fornisce nomi alternativi per un campo che potrebbe essere visualizzato nell'URL di una query. Può essere utile nei casi in cui i nomi dei campi di un modello cambiano, ma alcune persone hanno condiviso link ai dati e vuoi che questi URL preesistenti continuino a funzionare.
view_label (Esplora)
Il parametro view_label di un'esplorazione modifica l'etichetta del gruppo di campi della visualizzazione di base di un'esplorazione nel selettore campi senza modificare il modo in cui l'esplorazione e i relativi campi vengono referenziati in LookML.
Ad esempio, se unisci una vista order_facts a un'esplorazione chiamata order_items, puoi utilizzare il parametro view_label per impostare l'etichetta che Looker visualizza per la vista order_facts nel selettore di campi nel seguente modo:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
In questo esempio, la visualizzazione order_facts viene visualizzata come Ordini e altro nel selettore di campi dell'esplorazione Elementi ordine.
view_label (partecipa)
Il parametro view_label di un'unione ti consente di raggruppare i campi di una vista sotto il nome di un'altra vista nel selettore di campi. Se non aggiungi esplicitamente un view_label a un'unione, il view_label viene impostato per impostazione predefinita sul nome dell'unione.
Ad esempio, unisci la visualizzazione products all'esplorazione product_facts:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
In questo esempio, poiché non è specificata un'etichetta visualizzazione, i campi della visualizzazione products sono raggruppati sotto l'etichetta visualizzazione Prodotti nel selettore dei campi, separati dalla visualizzazione Fatti del prodotto:
Puoi utilizzare il parametro view_label per aggiungere un'etichetta di visualizzazione alla visualizzazione products unita, come nel seguente esempio:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
In questo modo, i campi della visualizzazione products vengono raggruppati sotto l'etichetta della visualizzazione Fatti sul prodotto nel selettore di campi:
label (visualizzazione)
Il parametro label di una vista modifica l'etichetta della vista nel selettore di campi senza modificare il modo in cui viene fatto riferimento in LookML. Se non specificata, l'etichetta viene impostata automaticamente sul nome della visualizzazione. A differenza di view_label (Explore) e view_label (Join), questo parametro influisce su tutti gli Explore che utilizzano la visualizzazione.
Ad esempio, puoi utilizzare il parametro label per specificare un'etichetta per la visualizzazione inventory_items come segue:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
In questo esempio, il selettore di campi mostra l'etichetta Articoli nell'inventario per la visualizzazione inventory_items, anziché l'etichetta predefinita Articoli di inventario.
description (campo)
Puoi aggiungere un description a qualsiasi campo. Per le connessioni BigQuery, se generi un progetto LookML a partire dal tuo database, Looker popola automaticamente le descrizioni dei campi con le descrizioni dei metadati delle colonne di BigQuery, se disponibili.
L'utente può visualizzare questa descrizione in più punti. Looker visualizza la descrizione quando l'utente seleziona l'icona delle informazioni a destra del nome del campo nel selettore dei campi.
Inoltre, Looker mostra la descrizione anche quando l'utente passa il mouse sopra il nome della colonna in una visualizzazione a tabella o grafico a tabella in un'esplorazione, una dashboard o un look.
hidden (campo)
Per impostazione predefinita, i campi specificati in una visualizzazione vengono visualizzati nel selettore di campi. Il parametro hidden del campo nasconde un campo nel selettore dei campi.
È comunque possibile accedere ai campi nascosti nell'interfaccia utente se vengono aggiunti manualmente all'URL e vengono visualizzati in alcune finestre di Looker. Pertanto, considera hidden come un modo per mantenere pulito il selettore di campi e non come una funzionalità di sicurezza.
Ad esempio, l'aggiunta del codice LookML hidden: yes al codice LookML per la dimensione product_id nell'esempio seguente nasconde la dimensione ID prodotto dal selettore di campi:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (campo)
Il parametro fields consente di specificare quali campi della visualizzazione di base e delle unioni di un'esplorazione vengono visualizzati nel selettore di campi. Se non utilizzi il parametro fields, Looker espone tutti i campi.
Per specificare i campi da visualizzare nel selettore di campi, utilizza un elenco separato da virgole di campi o insiemi. Per specificare i campi da nascondere nel selettore di campi, utilizza il set ALL_FIELDS* con un elenco separato da virgole dei campi o dei set da escludere, con un trattino (-) prima di ciascuno.
Ad esempio, puoi utilizzare il seguente codice LookML per visualizzare solo una selezione di campi dell'esplorazione aircraft nel selettore di campi:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
In questo esempio, l'esplorazione Aircraft mostra solo le dimensioni Aircraft Model Code, Aircraft Engine Code, City, Country e Zip e la metrica Count nel selettore dei campi.
label (campo)
Il parametro label di un campo ti consente di modificare la modalità di visualizzazione del nome di un campo nel selettore di campi senza modificare il modo in cui viene fatto riferimento in LookML. Se non viene specificata alcuna etichetta, l'etichetta predefinita è il nome del campo.
Ad esempio, puoi utilizzare il parametro label per impostare un'etichetta per la dimensione cost nel seguente modo:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
In questo esempio, la dimensione Costo ha l'etichetta Prezzo nel selettore di campi.
view_label (campo)
Il parametro view_label di un campo ti consente di modificare il nome della visualizzazione in cui il campo è elencato nel selettore dei campi senza modificare il modo in cui viene fatto riferimento in LookML. Se non viene specificata alcuna etichetta, il campo viene visualizzato sotto l'etichetta della visualizzazione in cui è definito.
Ad esempio, puoi utilizzare il parametro view_label nel seguente modo per specificare un'etichetta di visualizzazione per la dimensione cost:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
In questo esempio, Looker mostra la dimensione Costo sotto l'etichetta della visualizzazione Informazioni sui costi nel selettore di campi.
group_label (campo)
Il parametro group_label ti consente di combinare i campi in un elenco a discesa comune all'interno di una visualizzazione nel selettore di campi.
In questo esempio, il gruppo Informazioni di spedizione include i campi Città di spedizione, Paese di spedizione e Stato di spedizione:
group_item_label (campo)
Quando i campi vengono visualizzati sotto un'etichetta di gruppo, potrebbe non essere necessario visualizzare i nomi o le etichette completi nel selettore di campi. Nell'esempio mostrato in precedenza per group_label (campo), l'etichetta del gruppo indica già che i campi si riferiscono alla spedizione. In questi casi, puoi aggiungere il parametro group_item_label a ciascuno di questi campi raggruppati per modificare il loro aspetto sotto l'etichetta del gruppo.
In questo esempio, il gruppo Dati di spedizione include i campi Città, Paese e Stato:
