Puoi utilizzare una serie di parametri LookML per rendere le esplorazioni più facili da utilizzare modificando il modo in cui i campi vengono visualizzati nell'interfaccia utente senza modificare la modalità LookML sottostante. Questa pagina offre una panoramica dei parametri LookML che modificano l'aspetto del menu Looker Explore e del selettore campi.
| In Looker, gli utenti possono vedere le esplorazioni elencate nel menu Esplora. |
All'interno di un'esplorazione, i tuoi utenti possono utilizzare il selettore dei campi per selezionare i campi (dimensioni e misure) da utilizzare per eseguire query sui dati. |
|
|
In questa pagina sono elencati i parametri di uso comune con un link alla pagina di riferimento completa, una breve descrizione della funzione e un'immagine della funzione.
Per suggerimenti e suggerimenti su come semplificare l'esplorazione, consulta la pagina delle best practice per creare un'esperienza positiva per gli utenti di Looker.
Scopri nome e menu
In questa sezione viene descritto il comportamento predefinito del nome e dell'aspetto di un'esplorazione nel menu Esplora, poi vengono descritti i parametri LookML che consentono di modificare questo comportamento:
Comportamento predefinito del menu Esplora
Nomi dei modelli
Per impostazione predefinita, il menu Esplora è organizzato in base ai nomi dei modelli, che sono stabiliti in base al nome di ciascun file del modello. Il menu Esplora mostra una versione formattata del nome del modello, con trattini bassi cambiati in spazi e ogni parola in maiuscolo. Sotto il nome di ogni modello è riportato un elenco delle esplorazioni definite nel file del modello.
Esplora i nomi
Il nome di ogni Explore 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 siano cambiati in spazi e che ogni parola sia maiuscola. Il nome Esplora viene visualizzato anche come titolo Esplora al di sopra del selettore campi.
Nell'esempio seguente, l'esplorazione order_items è definita nel file 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
}
}
Lo strumento Esplora di order_items viene visualizzato come Articoli dell'ordine nel menu Esplora e nel selettore campi.
| Menu Esplora: | Selettore campo: |
 |
 |
Per ulteriori informazioni sui file del modello, consulta la pagina Documentazione relativa ai file 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 un modello nel menu Esplora senza modificarne la modalità di 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 viene fatto riferimento al modello nelle impostazioni di LookML e di amministrazione rimane invariato.
Per impostazione predefinita, il modello market_research.model compare 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 come segue nel menu Explore (Esplora):
label (esplorazione)
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 Esplora viene visualizzato in base al suo comportamento predefinito.
group_label (esplorazione)
Il parametro group_label di Esplora esplora l'organizzazione predefinita del menu Esplora. Invece di elencare ogni Explore sotto il nome del relativo modello, group_label ti permette di definire un'intestazione personalizzata sotto la quale elencare una o più esplorazioni.
In questo esempio, le opzioni Clienti, Inventario, Articoli dell'ordine e Dati utente sono elencati sotto l'etichetta del gruppo Query negozio online:
description (esplorazione)
Il parametro description di un'esplorazione consente di aggiungere una descrizione di un'esplorazione all'interfaccia utente, in modo che gli utenti possano ottenere ulteriori informazioni durante la creazione dei report.
Gli utenti possono vedere la descrizione passando il mouse sopra l'icona delle informazioni, accanto al nome Esplora nella parte superiore del selettore 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 (esplorazione)
Il parametro hidden di un'esplorazione nasconde la funzionalità Esplora dal menu Esplora. Per impostazione predefinita, la funzionalità hidden non è attiva e l'esplorazione verrà visualizzata. hidden non nasconde LookML né impedisce l'accesso a Explore tramite l'URL. hidden non è pensato come funzionalità di sicurezza, quanto piuttosto come funzionalità di presentazione.
Ad esempio, se aggiungi il codice LookML hidden: yes a LookML per Esplora inventory nell'esempio seguente, l'esplorazione Inventario è visibile 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 campo
Questa sezione descrive il comportamento predefinito del selettore campo, quindi descrive i parametri LookML che ti consentono di modificare questo comportamento.
Cambia la modalità di visualizzazione dei nomi di visualizzazione nel selettore campi con:
Cambia la modalità di visualizzazione dei nomi dei singoli campi nel selettore campi con:
Cambia l'organizzazione dei campi all'interno del selettore campi con:
Comportamento predefinito del selettore campi
Per impostazione predefinita, il selettore dei campi è organizzato in base alle intestazioni che corrispondono alle viste specificate dal parametro LookML view. I campi di ogni vista vengono raggruppati nel selettore di campi. Il tipo di campo (dimensione, gruppo di dimensioni, misura, campo filtro e campo parametro) determina dove viene mostrato il campo all'interno della vista. A meno che non venga utilizzato il parametro label per modificare il nome visualizzato, il selettore dei campi mostrerà una versione formattata della vista LookML o del nome del campo, con i trattini bassi cambiati in spazi e ogni parola in maiuscolo.
Nell'esempio seguente, Looker visualizza la vista accounts come Accounts (Account) nel selettore dei campi, che è il comportamento predefinito:
view: accounts {
sql_table_name: accounts ;;
}
Il seguente esempio mostra in che modo i nomi di una dimensione, di un gruppo di dimensioni e di una misura vengono visualizzati per impostazione predefinita. La stessa formattazione verrà applicata ai nomi dei 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 dei campi mostra i nomi predefiniti dei campi: Numero account, Nome, Data di creazione ed Entrate medie annue, rispettivamente per le dimensioni account_number e name, il gruppo di dimensioni created e la misura average_annual_revenue.
Se modifichi il nome di un campo, il selettore dei campi viene adattato al nuovo nome, ma potresti voler 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 che questi URL preesistenti funzionino.
view_label (esplorazione)
Il parametro view_label di un'esplorazione cambia il modo in cui il gruppo di campi della visualizzazione di base di un'esplorazione viene etichettato nel selettore di campi, senza modificare il riferimento all'esplorazione e ai relativi campi 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 mostrata da Looker 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 campi dell'esplorazione Articoli articoli.
view_label (Partecipa)
Il parametro view_label di un join consente di raggruppare i campi da una vista sotto il nome di un'altra vista nel selettore campi. Se non aggiungi esplicitamente un view_label a un join, il valore predefinito di view_label è il nome del join.
Ad esempio, ti unisci alla vista products per esplorare 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 è stata specificata un'etichetta di visualizzazione, i campi della vista products sono raggruppati sotto l'etichetta della visualizzazione Prodotti nel selettore campi, separati dalla vista Dati prodotto:
Puoi utilizzare il parametro view_label per aggiungere un'etichetta di visualizzazione alla vista products collegata, 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 visualizzazione products sono contrassegnati dall'etichetta Fatti sui prodotti nel selettore campi:
label (visualizza)
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 specificata, il valore predefinito dell'etichetta è 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 vista inventory_items nel seguente modo:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
In questo esempio, il selettore dei campi mostra l'etichetta Elementi nell'inventario per la visualizzazione inventory_items, anziché l'etichetta predefinita Elementi dell'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ù punti. Looker visualizza la descrizione quando l'utente seleziona l'icona delle informazioni a destra del nome del campo nel selettore campi.
Inoltre, Looker mostra la descrizione anche quando l'utente passa il mouse sopra il nome della colonna in una tabella o in un grafico a tabella in Esplora, dashboard o Look.
hidden (campo)
Per impostazione predefinita, i campi specificati in una vista vengono visualizzati nel selettore campi. Il parametro hidden del campo nasconde un campo nel selettore campi.
Puoi accedere ai campi nascosti nell'interfaccia utente se vengono aggiunti manualmente all'URL e verranno visualizzati in alcune finestre di Looker. Pertanto, pensa a hidden come a un modo per mantenere pulito il selettore dei campi e non come una funzionalità di sicurezza.
Ad esempio, se aggiungi il codice LookML hidden: yes alla dimensione LookML per la dimensione product_id nell'esempio seguente, la dimensione ID prodotto viene nascosta dal selettore dei campi:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (campo)
Il parametro fields ti consente di specificare quali campi della visualizzazione di base di un'esplorazione e di join 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 di campi o insiemi separato da virgole. 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, seguito da un trattino (-).
Ad esempio, puoi utilizzare il codice LookML seguente per visualizzare solo una selezione di campi dall'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, Aircraft Explore visualizza solo le dimensioni Aircraft Model Code, Aircraft Engine Code, City, Country e Zip e la misurazione Count nel conteggio dei campi.
label (campo)
Il parametro label di un campo consente di modificare il modo in cui il nome del campo apparirà nel selettore dei campi senza modificare la sua modalità di 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 nel seguente 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 sotto 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 apparirà sotto l'etichetta della vista in cui è stata definita.
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 visualizza la dimensione Cost sotto l'etichetta di visualizzazione 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 in una vista all'interno del selettore campi.
In questo esempio, il gruppo Informazioni sulla spedizione include i campi Città di spedizione, Paese di spedizione e Stato spedizione:
group_item_label (campo)
Quando i campi vengono visualizzati sotto un'etichetta di gruppo, potrebbe non essere necessario visualizzare i nomi completi o le etichette del selettore di 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 modificare il loro aspetto sotto l'etichetta del gruppo.
In questo esempio, il gruppo Informazioni sulla spedizione include i campi Città, Paese e Stato:
