Questa pagina offre una panoramica dei file di modelli e viste, che sono componenti chiave della maggior parte dei progetti Looker. Gli altri tipi di file di progetto sono descritti nella pagina della documentazione Comprendere altri file di progetto. Per informazioni sull'accesso ai file di un progetto, consulta la pagina della documentazione Accesso e modifica delle informazioni sul progetto.
File del modello
Un file modello specifica una connessione al database e l'insieme di esplorazioni che utilizzano tale connessione. Un file modello definisce anche le esplorazioni stesse e le loro relazioni con le altre viste.
Un'esplorazione è un punto di partenza per eseguire query sui dati. In termini SQL, un'esplorazione è la clausola FROM
di una query. Le esplorazioni che definisci nel modello vengono visualizzate dagli utenti quando guardano il menu Explore di Looker. Per ulteriori informazioni sulle esplorazioni, consulta la pagina Documentazione su come funziona un progetto in Looker.
In altre parole, il file del modello è il punto in cui definisci le tabelle di dati da utilizzare (come le visualizzazioni incluse) e come devono essere unite, se necessario.
Le esplorazioni sono generalmente definite all'interno di un file modello. Tuttavia, a volte è necessario un file Esplora separato per una tabella derivata oppure per estendere o perfezionare un'esplorazione tra i modelli.
Struttura e sintassi generale
Tra le parentesi graffe di Esplora, { }
, definisci i parametri dell'esplorazione. Puoi utilizzare i parametri join
per unire altre viste a un'esplorazione in un file modello.
Sopra vediamo il file explore
, chiamato inventory_items
, nel file del modello e le relative visualizzazioni unite. Questa definizione di LookML fa sì che gli Elementi inventario vengano visualizzati nel menu Esplora e unisce i dati dal giorno inventory_items
al giorno products
e distribution_centers
.
Per informazioni più specifiche sulle strutture LookML in un file modello, consulta la pagina della documentazione relativa ai termini e concetti di LookML.
Creazione di file modello
La maggior parte degli sviluppatori LookML inizia con uno o più file di modello creati automaticamente quando il progetto LookML viene generato da un set di tabelle in un database.
In alternativa, uno sviluppatore di Looker in modalità di sviluppo può creare un file modello vuoto nei seguenti modi:
- Tramite l'opzione Create Model File (Crea file modello) puoi creare il file utilizzando l'IDE di Looker. Consulta la sezione Creazione di file nella pagina della documentazione relativa all'utilizzo delle cartelle nella documentazione dell'IDE.
- Utilizza la funzionalità di trascinamento dei file per caricare il file dal computer (consulta la sezione Caricamento di file nella pagina della documentazione relativa all'utilizzo delle cartelle nell'IDE). Assicurati di utilizzare l'estensione
.model.lkml
per il file che stai caricando.
Puoi modificare qualsiasi file del modello aggiungendo o rimuovendo le esplorazioni, specificando le unioni e aggiungendo altre funzionalità.
Se devi rinominare un modello o un qualsiasi oggetto nel modello, non rinominare il file o l'oggetto stesso. Utilizza invece il parametro
label
oalias
per modificare il nome visualizzato del file o dell'oggetto. I parametrilabel
ealias
modificano il nome visualizzato mantenendo l'URL sottostante utilizzato per le email o altri sistemi.In generale, dovresti prendere le precauzioni per apportare modifiche al modello il più invasive possibile. Se devi rinominare un modello o un oggetto, utilizza lo Strumento di convalida dei contenuti per aggiornare tutti i riferimenti al modello o all'oggetto.
Se elimini un file modello, il modello non viene rimosso da alcun set di modelli a cui apparteneva. Se viene creato un nuovo file modello con lo stesso nome di un modello eliminato, il nuovo modello verrà incluso in tutti i set di modelli che includono il modello eliminato. Ciò può comportare l'accesso indesiderato al nuovo file modello. Per evitare questo problema, gli amministratori di Looker possono modificare i set di modelli e rimuovere un modello eliminato.
Scopri di più sui parametri nei file modello
Per ulteriori informazioni sui parametri LookML nel file modello, consulta le pagine della documentazione Parametri del modello, Parametri di esplorazione e Unisci parametri.
Visualizza file
Un file di vista definisce generalmente un'unica "vista" all'interno di Looker. Una vista corrisponde a una singola tabella nel tuo database o una singola tabella derivata.
Il file di vista specifica una tabella per la query e i campi (dimensioni e misure) da includere da questa tabella.
Struttura e sintassi generale
Le parentesi graffe di ogni vista, { }
, sono definizioni di campi, che di solito corrispondono a una colonna nella tabella sottostante o a un calcolo in Looker. Looker classifica la maggior parte di questi come dimensioni o misure.
Sopra viene mostrata la dimensione id
definita come campo nella visualizzazione Articoli dell'ordine. Questa definizione espone il campo ID per le query nell'area di esplorazione degli articoli dell'ordine.
Puoi anche creare più dimensioni basate sul tempo contemporaneamente utilizzando i gruppi di dimensioni o specificare un filtro per gli utenti con i campi filtro. Per ulteriori informazioni sui parametri LookML nei file delle viste, consulta la pagina Documentazione parametri della vista.
Per informazioni più specifiche sulle strutture LookML in un file di vista, consulta la pagina della documentazione relativa ai termini e concetti di LookML.
Dimensioni
I campi in Looker sono suddivisi in dimensioni e misure. Una dimensione può essere una delle due seguenti cose:
- Una colonna nella tabella sottostante
dimension: first_name {
sql: ${TABLE}.first_name ;;
}
- Un valore calcolato in base ad altri campi
dimension: full_name {
sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
In Looker, le dimensioni vengono sempre visualizzate nella clausola GROUP BY
dell'SQL generato da Looker.
In LookML, puoi definire diversi tipi di dimensione che corrispondono a diversi tipi di dati o formattazione.
Misure
Una misura calcola i valori su più righe. Equivale a funzioni di aggregazione SQL come COUNT()
, SUM()
, AVG()
, MIN()
e MAX()
. Le misure possono anche eseguire semplici trasformazioni su altre misure. Per saperne di più, consulta la documentazione relativa ai tipi di misurazione.
Sopra possiamo vedere le dimensioni e le misure definite nel file della vista products
.
Creazione di file di viste
La maggior parte degli sviluppatori LookML inizia con uno o più file di vista creati automaticamente quando il progetto LookML viene generato da un set di tabelle in un database. Tuttavia, esistono molti modi in cui gli sviluppatori di Looker che utilizzano la modalità di sviluppo possono aggiungere file di visualizzazione a un progetto LookML:
Creazione dei file delle viste in base alle tabelle in un database:
- La generazione di file di viste da tabelle di database alla prima connessione al database, come descritto nella pagina di documentazione Generazione di un modello.
- Generazione di file di viste dalle tabelle di database per un progetto già collegato a un database, come descritto nella sezione Aggiungere una nuova vista da una tabella di database esistente di seguito in questa pagina.
Creazione di file di viste vuoti:
- Utilizzando l'opzione Create View File (Crea file di visualizzazione) nell'IDE di Looker, come descritto nella sezione Creating files (Creazione di file) della pagina della documentazione Utilizzo delle cartelle.
- Utilizza la funzionalità di trascinamento dei file per caricare il file dal computer, come descritto nella sezione Caricare i file nella pagina della documentazione Utilizzo delle cartelle nella IDE. Assicurati di utilizzare l'estensione
.view.lkml
per il file che stai caricando.
Creazione di un file di vista per una tabella derivata:
- A partire da un file di vista vuoto utilizzando una delle opzioni precedenti, quindi definendo manualmente la tabella derivata, come descritto nella sezione Definire una tabella nativa nativa in LookML della pagina della documentazione Creazione di tabelle derivate native.
- Lasciando che Looker crei la LookML della tabella derivata da un'esplorazione, come descritto nella sezione Utilizzo di un'esplorazione per iniziare a definire le tabelle native derivate della pagina della documentazione Creazione di tabelle derivate native.
- Chiedendo a Looker di creare la tabella LookML derivata da una query SQL Runner, come descritto nella pagina della documentazione Utilizzo di SQL Runner per creare tabelle derivate.
Per utilizzare una nuova vista, aggiungila al file del modello utilizzando il parametro explore
oppure utilizza il parametro join
per unirla a un'esplorazione esistente nel file del modello.
Aggiunta di una nuova vista da una tabella di database esistente
Puoi creare un file di visualizzazione da una tabella di database esistente in modalità Sviluppo.
All'interno di un progetto, fai clic su + nella parte superiore dell'elenco dei file del progetto nell'IDE di Looker oppure fai clic sul menu di una cartella per creare il file all'interno della cartella.
Fai clic su Crea visualizzazione da tabella.
Looker visualizza un elenco di tabelle associate a una delle tue connessioni. Per modificare la connessione, utilizza il menu a discesa Connessione in alto a sinistra.
Seleziona le tabelle da cui creare viste selezionando la casella a sinistra del nome della tabella. Puoi comprimere ed espandere i database o gli schemi in questo elenco per accedere a tutte le tabelle disponibili.
Scorri fino in fondo alla pagina e fai clic su Crea viste.
Looker genera visualizzazioni contenenti LookML per tutte le colonne della tabella.
Scopri di più sui parametri nei file delle viste
Puoi scoprire di più sui parametri di visualizzazione nella pagina della documentazione Parametri di visualizzazione.
Scopri di più sui parametri LookML per le dimensioni, le misure, i gruppi di dimensioni e i campi filtro nella pagina della documentazione Parametri dei campi.