Modificare il menu Esplora e il selettore campi

Puoi utilizzare una serie di parametri LookML per rendere le tue esplorazioni più facili da usare modificando il modo in cui i campi vengono visualizzati nell'interfaccia utente senza modificare il 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 vedere 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 propri dati.

Le esplorazioni sono elencate nel menu Esplora sotto il nome del modello a cui appartengono. Il selettore campi in un'esplorazione mostra un elenco espandibile di viste contenenti i campi che puoi aggiungere alla query.

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 della sua funzione.

Per suggerimenti e suggerimenti su come creare un'esplorazione facile da usare, consulta la pagina Best practice: creare un'esperienza positiva per gli utenti di Looker.

Esplora nome e menu

Questa sezione descrive il comportamento predefinito relativo al nome e all'aspetto di un'esplorazione nel menu Esplora, quindi descrive i parametri LookML che ti consentono di modificare questo comportamento:

Esplora 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 ciascun file del modello. Il menu Esplora mostra una versione formattata del nome del modello, con trattini bassi modificati in spazi e ogni parola in maiuscolo. Sotto il nome di ogni modello è presente 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, anche i nomi delle esplorazioni sono formattati nel menu in modo che i trattini bassi vengano convertiti in spazi e ogni parola sia maiuscola. Il nome dell'esplorazione viene visualizzato anche come titolo dell'esplorazione sopra il 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
  }
}

L'esplorazione order_items viene visualizzata come Articoli dell'ordine nel menu Esplora e nel selettore campi.

Menu Esplora: Selettore campi:

Gli elementi dell'ordine vengono visualizzati nell'elenco delle esplorazioni del menu Esplora. L'etichetta Elementi dell'ordine viene visualizzata in alto a sinistra nel riquadro del selettore campi.

Per ulteriori informazioni sui file del modello, consulta la pagina della documentazione Informazioni sui file dei modelli e della visualizzazione. Per saperne di più 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 la modalità di riferimento in LookML. Le esplorazioni degli URL, l'IDE Looker e SQL Runner riflettono comunque il nome effettivo del modello; la modalità di riferimento al modello nelle impostazioni LookML e amministratore rimane invariata.

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 come segue nel menu Esplora:

Il modello Ricerche di mercato ha l'etichetta R&S marketing 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.

Un'esplorazione con l'etichetta Informazioni sugli articoli dell'ordine nel menu Esplora e nel selettore campi.

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 modello, group_label ti consente di definire un'intestazione personalizzata in base alla quale elencare una o più esplorazioni.

In questo esempio, le esplorazioni Clienti, Inventario, Articoli ordine e Dati utente sono elencati sotto l'etichetta del gruppo Query negozio online:

Esplorazioni elencate nell'etichetta del gruppo di query del negozio online nel menu Esplora.

description (Esplora)

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 visualizzare la descrizione passando il mouse sopra l'icona delle informazioni accanto al nome dell'esplorazione 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, l'opzione hidden è disattivata e verrà visualizzata l'esplorazione. hidden non nasconde LookML o impedisce l'accesso a un'esplorazione tramite l'URL. hidden non è da intendersi come una funzionalità di sicurezza, ma come una funzionalità di presentazione.

Ad esempio, l'aggiunta del codice LookML hidden: yes al codice LookML per l'esplorazione inventory nell'esempio seguente nasconde l'esplorazione Inventario nel 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 campi e i parametri LookML che ti consentono di modificarlo.

Modifica l'aspetto dei nomi delle viste nel selettore campi con:

Modifica il modo in cui i nomi dei singoli campi vengono visualizzati nel selettore campi con:

Modifica il modo in cui i campi sono organizzati nel selettore campi con:

Comportamento predefinito del selettore campi

Per impostazione predefinita, il selettore campi è organizzato in base a intestazioni corrispondenti alle visualizzazioni specificate dal parametro view di 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 mostrato il campo nella visualizzazione. A meno che il parametro label non venga utilizzato per modificare il nome visualizzato, il selettore campi mostrerà una versione formattata della vista o del nome del campo LookML, con trattini bassi modificati 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 dimensione, gruppo di dimensioni e misura. La stessa formattazione verrà applicata ai nomi di tutti i campi filtro e di parametro.


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 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 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 che gli URL preesistenti continuino a funzionare.

view_label (Esplora)

Il parametro view_label di un'esplorazione modifica il modo in cui il gruppo di campi di un'esplorazione di base viene etichettato nel selettore 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 visualizza per la order_facts vista nel selettore 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 vista order_facts appare come Ordini e altro nel selettore campi dell'esplorazione Elementi dell'ordine.

view_label (abbonamento)

Il parametro view_label di un join ti consente di raggruppare i campi di una vista sotto il nome di un'altra vista nel selettore campi. Se non aggiungi esplicitamente view_label a un join, per impostazione predefinita view_label viene utilizzato il nome del join.

Ad esempio, unisci la vista 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 viene specificata l'etichetta di una vista, i campi della vista products vengono raggruppati sotto l'etichetta della vista Prodotti nel selettore di campi, separata dalla visualizzazione Informazioni sul prodotto:

I campi della visualizzazione Prodotto sono raggruppati per impostazione predefinita nell'etichetta della visualizzazione Prodotto.

Puoi utilizzare il parametro view_label per aggiungere un'etichetta vista alla vista 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
  }
}

I campi della vista products vengono raggruppati sotto l'etichetta Informazioni sul prodotto nel selettore di campi:

I campi della visualizzazione Prodotto sono raggruppati nell'etichetta di visualizzazione Informazioni sul prodotto.

label (visualizzazione)

Il parametro label di una vista modifica il modo in cui la vista viene etichettata nel selettore campi senza cambiare il modo in cui viene fatto riferimento in LookML. Se non specificata, l'etichetta mostra per impostazione 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 vista inventory_items nel seguente modo:


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 Articoli nell'inventario.

description (campo)

Puoi aggiungere un elemento description a qualsiasi campo. Per le connessioni BigQuery, se generi un progetto LookML dal tuo database, Looker compilerà automaticamente le descrizioni dei campi con le descrizioni dei metadati delle colonne BigQuery, se presenti.

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 una visualizzazione di grafico a tabella di un'esplorazione, una dashboard o un Look.

hidden (campo)

Per impostazione predefinita, i campi specificati in una vista verranno mostrati nel selettore 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 vengono visualizzati in alcune finestre di Looker. Pertanto, considera hidden come un modo per tenere pulito il selettore campi, 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 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 dei join di un'esplorazione devono essere esposti nel selettore 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 di campi o insiemi separati da virgole. Per specificare i campi da nascondere dal selettore campi, utilizza l'insieme ALL_FIELDS* con un elenco separato da virgole dei 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 nonché la misura Count nel selettore di campi.

label (campo)

Il parametro label di un campo ti consente di modificare il modo in cui un nome campo verrà visualizzato nel selettore di campi senza modificare il modo in cui viene indicato in LookML. Se non viene specificata alcuna etichetta, il valore predefinito dell'etichetta sarà 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 price nel selettore di campi.

view_label (campo)

Il parametro view_label di un campo ti consente di modificare il nome della vista in cui il campo è elencato nel selettore di 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 relativa alla vista in cui è stata definita.

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 di 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 vista nel selettore campi.

In questo esempio, il gruppo Informazioni sulla spedizione include i campi Città spedizione, Paese spedizione e Stato spedizione:

Il gruppo Informazioni sulla spedizione nel selettore dei campi di un'esplorazione.

group_item_label (campo)

Quando i campi vengono visualizzati sotto l'etichetta di un gruppo, nel selettore campi potrebbe non essere necessario visualizzare i nomi completi o le etichette dei campi. Nell'esempio mostrato in precedenza per group_label (campo), l'etichetta del gruppo indica già che i campi sono relativi alla spedizione. In casi come questo, puoi aggiungere il parametro group_item_label a ciascuno di questi campi raggruppati per cambiarne l'aspetto sotto l'etichetta del gruppo.

In questo esempio, il gruppo Informazioni sulla spedizione include i campi Città, Paese e Stato:

Il gruppo Informazioni sulla spedizione nel selettore dei campi di un'esplorazione.