Puoi utilizzare diversi parametri LookML per rendere le tue esplorazioni più facili da usare modificando il modo in cui i campi vengono visualizzati 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 campi.
In Looker, gli utenti possono visualizzare le esplorazioni nel menu Esplora. | All'interno di un'esplorazione, gli utenti possono utilizzare il selettore campi per selezionare i campi (dimensioni e misure) da utilizzare per eseguire query sui dati. |
In questa pagina sono elencati tutti i parametri di uso comune con un link alla pagina di riferimento completa, una breve descrizione della relativa funzione e un'immagine della funzione.
Per suggerimenti e suggerimenti sulla creazione di un'esplorazione facile da usare, vedi la pagina delle best practice per Best practice: creare un'esperienza positiva per gli utenti di Looker.
Esplora nome e menu
In questa sezione viene descritto il comportamento predefinito del nome e l'aspetto di un'esplorazione nel menu Esplora e vengono descritti i parametri LookML che consentono di modificare tale comportamento:
Comportamento predefinito del menu Esplora
Nomi dei modelli
Per impostazione predefinita, il menu Esplora è organizzato in base ai nomi dei modelli, che sono determinati dal nome di ciascun file del modello. Il menu Esplora mostra una versione formattata del nome del modello, con i trattini bassi in spazi e la lettera maiuscola per ogni parola. Sotto il nome di ciascun modello è riportato un elenco delle esplorazioni definite nel file del modello.
Esplora nomi
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 convertiti in spazi e che ogni parola sia maiuscola. Il nome dell'esplorazione viene mostrato 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 di modello e 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 il modello nel menu Esplora senza modificare il modo in cui vi viene fatto riferimento in LookML. Gli URL di esplorazione, l'IDE di Looker e SQL Runner riflettono ancora il nome effettivo del modello; il modo in cui fare riferimento al modello in LookML e nelle impostazioni di amministrazione rimane invariato.
Per impostazione predefinita, il modello market_research.model
viene visualizzato come Ricerca 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 come segue nel menu Esplora:
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 suo comportamento predefinito.
group_label
(Esplora)
Il parametro group_label
di un'esplorazione modifica l'organizzazione predefinita del menu Esplora. Anziché elencare ogni esplorazione sotto il nome del relativo 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 ordine e Dati utente sono elencate sotto l'etichetta del gruppo Query sul negozio online:
description
(Esplora)
Il parametro description
di un'esplorazione ti consente di aggiungere la descrizione di un'esplorazione all'interfaccia utente, in modo che gli utenti possano ricevere ulteriori informazioni durante la creazione dei report.
Gli utenti possono visualizzare la descrizione passando il mouse sopra l'icona delle informazioni accanto al nome dell'esplorazione nella parte superiore del selettore dei 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, l'opzione hidden
è disattivata e verrà visualizzata l'esplorazione. 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, se aggiungi il codice LookML hidden: yes
al LookML per l'esplorazione inventory
nell'esempio seguente, 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
In questa sezione viene descritto il comportamento predefinito del selettore campi e vengono descritti i parametri LookML che consentono di modificare questo comportamento.
Modifica il modo in cui i nomi delle viste vengono visualizzati nel selettore campi con:
Modifica il modo in cui i nomi dei singoli campi vengono visualizzati nel selettore campi con:
Modifica l'organizzazione dei campi nel selettore dei campi con:
Comportamento predefinito selettore campi
Per impostazione predefinita, il selettore campi è organizzato in intestazioni che corrispondono alle visualizzazioni specificate dal parametro view
LookML. I campi di ogni vista sono raggruppati nel selettore campi. Il tipo di campo (dimensione, gruppo di dimensioni, misura, campo filtro e campo parametro) determina dove viene visualizzato il campo all'interno della visualizzazione. A meno che non venga utilizzato il parametro label
per modificare il nome visualizzato, il selettore campi mostrerà una versione formattata della visualizzazione LookML o del nome del campo, con i trattini bassi in spazi e ogni parola in maiuscolo.
Nell'esempio seguente, Looker mostra la vista accounts
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 eventuali campi di filtro e 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 predefiniti dei campi Numero account, Nome, Data di creazione ed Entrate annuali 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 ti consigliamo di aggiungere un parametro alias
con il nome precedente 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 in un modello cambiano, ma alcune persone hanno link condivisi ai dati e vuoi mantenere gli URL preesistenti funzionanti.
view_label
(Esplora)
Il parametro view_label
di un'esplorazione modifica il modo in cui viene etichettato il gruppo di campi della vista di base di un'esplorazione nel selettore di campi senza modificare il modo in cui viene fatto riferimento all'esplorazione e ai relativi campi in LookML.
Ad esempio, se unisci una vista order_facts
a un'esplorazione denominata order_items
, puoi utilizzare il parametro view_label
per impostare l'etichetta che Looker mostra per la vista order_facts
nel selettore campi come segue:
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 join consente di raggruppare i campi di una vista sotto il nome di un'altra vista nel selettore dei campi. Se non aggiungi esplicitamente view_label
a un join, l'elemento view_label
utilizzerà per impostazione predefinita il nome del join.
Ad esempio, partecipi alla 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 di vista, i campi della vista products
vengono raggruppati nell'etichetta della vista Prodotti nel selettore campi, separati dalla visualizzazione Informazioni sul prodotto:
Puoi utilizzare il parametro view_label
per aggiungere un'etichetta alla visualizzazione products
unita, come nell'esempio seguente:
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 vista products
vengono raggruppati sotto l'etichetta della vista Informazioni sul prodotto nel selettore campi:
label
(visualizzazione)
Il parametro label
di una vista cambia il modo in cui la vista viene etichettata nel selettore campi senza modificare il modo in cui viene fatto riferimento in LookML. Se non specificato, l'etichetta predefinita è il nome della visualizzazione. A differenza di view_label
(Esplora) e view_label
(Partecipa), questo parametro influisce su tutte le esplorazioni che utilizzano la vista.
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 campi mostra l'etichetta Elementi nell'inventario per la vista inventory_items
, anziché l'etichetta predefinita Elementi inventario.
description
(campo)
Puoi aggiungere una 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ù posizioni. Looker mostra 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 di tabelle o grafici 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 dei campi. Il parametro hidden
del campo nasconde un campo nel selettore campi.
È comunque possibile accedere ai campi nascosti nell'interfaccia utente se vengono aggiunti manualmente all'URL e verranno visualizzati in alcune finestre di Looker. Di conseguenza, pensa a hidden
come a un modo per mantenere pulito il selettore campi e non come una funzionalità di sicurezza.
Ad esempio, se aggiungi il codice LookML hidden: yes
al LookML per la dimensione product_id
nell'esempio seguente, nasconde la dimensione ID prodotto dal selettore campi:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields
(campo)
Il parametro fields
consente di specificare quali campi della vista di base e i join di un'esplorazione vengono esposti nel selettore dei campi. Se non utilizzi il parametro fields
, Looker espone tutti i campi.
Per specificare i campi da visualizzare nel selettore campi, utilizza un elenco separato da virgole di campi o insiemi. Per specificare i campi da nascondere dal selettore campi, utilizza l'insieme ALL_FIELDS*
con un elenco separato da virgole di campi o insiemi da escludere, preceduti da un trattino (-).
Ad esempio, puoi utilizzare il seguente codice LookML per visualizzare solo una selezione di campi dell'esplorazione aircraft
nel selettore 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 (Paese) e la misura Count nel selettore di campi.
label
(campo)
Il parametro label
di un campo consente di modificare il modo in cui il nome di un campo verrà visualizzato nel selettore campi senza modificare il modo in cui viene fatto riferimento in LookML. Se non viene specificata alcuna etichetta, per impostazione predefinita viene utilizzato il nome del campo.
Ad esempio, puoi utilizzare il parametro label
per impostare un'etichetta per la dimensione cost
in questo modo:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
In questo esempio, la dimensione Costo ha l'etichetta prezzo nel selettore campi.
view_label
(campo)
Il parametro view_label
di un campo consente di modificare il nome della vista in cui il campo è elencato nel selettore 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 vista in cui è definito.
Ad esempio, puoi utilizzare il parametro view_label
come segue 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 vista Informazioni sui costi nel selettore 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 sulla spedizione include i campi Città della spedizione, Paese della spedizione e Stato della spedizione:
group_item_label
(campo)
Quando i campi vengono mostrati sotto l'etichetta di un gruppo, potrebbe non essere necessario visualizzare i nomi completi dei campi o le etichette nel selettore campi. Nell'esempio mostrato in precedenza per group_label
(campo), l'etichetta del gruppo indica già che i campi riguardano la spedizione. In casi come questo, puoi aggiungere il parametro group_item_label
a ciascuno di questi campi raggruppati per modificarne l'aspetto nell'etichetta del gruppo.
In questo esempio, il gruppo Informazioni di spedizione include i campi Città, Paese e Stato: