Un progetto LookML è una raccolta di file LookML che indicano a Looker come connettersi al tuo database, come eseguire query sui dati e come controllare il comportamento dell'interfaccia utente. Puoi accedere ai file di progetto LookML dalla sezione Sviluppo di Looker o dalla UI, come descritto nella pagina della documentazione Accesso ai file di progetto LookML.
I file di progetto vengono organizzati dagli sviluppatori di Looker tramite le cartelle nell'IDE.
Un progetto LookML è costituito da almeno un file del modello e da almeno un file di vista ed eventualmente alcuni degli altri tipi di file descritti in questa pagina. Tutti i file di progetto hanno estensioni, anche se queste sono nascoste nell'elenco IDE se il tuo progetto non è abilitato per le cartelle nell'IDE.
Seleziona i seguenti link per scoprire di più su ogni tipo di file che può essere utilizzato in un progetto LookML:
- File modello con estensione
.model.lkml - Visualizza file con estensione
.view.lkml - File della dashboard con estensione
.dashboard.lookml - File di dati con estensione
.topojson,.geojsono.json - File di documento con estensione
.md - File manifest del progetto che hanno sempre il nome
manifest.lkml - File di blocco manifest con estensione
.lkml - File di stringhe locali con estensione
.strings.json - Esplora i file con estensione
.explore.lkml - File di test di dati con estensione
.lkml - File dei perfezionamenti con estensione
.lkml - Altri file con qualsiasi estensione di file non elencata in precedenza
Dopo aver creato un progetto LookML, puoi accedere ai file di progetto e aggiungere nuovi file e cartelle al progetto utilizzando l'IDE di Looker.
File del modello
Un file del modello specifica una connessione di database e l'insieme di Esplorazioni che la utilizzano. Un file del modello definisce anche le esplorazioni stesse e le relative relazioni con le altre viste. Un'esplorazione è il 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 nel menu Esplora di Looker.
In altre parole, nel file del modello definisci quali tabelle di dati utilizzare (come le viste incluse) e come devono essere unite, se necessario.
Per istruzioni sulla creazione dei file di progetto LookML, inclusi i file di modello, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Struttura e sintassi generale
Tra le parentesi graffe di un'esplorazione, { }, puoi definire i relativi parametri. Puoi utilizzare i parametri join per unire altre viste a un'esplorazione in un file del modello.
Nell'esempio seguente, il LookML in un file di modello di esempio definisce un'esplorazione denominata inventory_items, insieme alle relative viste unite:
connection: "thelook_events"
explore: inventory_items {
join: products {
type: left_outer
sql_on: ${inventory_items.product_id} = ${products.id} ;;
relationship: many_to_one
}
join: distribution_centers {
type: left_outer
sql_on: ${products.distribution_center_id} = ${distribution_center.id} ;;
relationship: many_to_one
}
}
Questa definizione LookML fa sì che gli elementi dell'inventario vengano visualizzati nella sezione Esplora della navigazione di Looker e unisce i dati delle viste products e distribution_centers alla vista inventory_items.
Per informazioni più specifiche sulle strutture LookML in un file di modello, consulta la pagina della documentazione Termini e concetti di LookML.
Per saperne di più sui parametri LookML nel file del modello, consulta le pagine della documentazione su Parametri modello, Parametri Esplora e Parametri di join.
Visualizza file
In genere, un file di visualizzazione definisce una singola "vista" all'interno di Looker. Una vista corrisponde a una singola tabella del database o a una singola tabella derivata. Il file di visualizzazione specifica una tabella su cui eseguire una query e i campi (dimensioni e misure) da includere da questa tabella, in modo che gli utenti possano creare query con questi campi nell'interfaccia utente di Looker.
Per istruzioni sulla creazione dei file di progetto LookML, inclusi i file delle viste, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Struttura e sintassi generale
All'interno delle parentesi graffe di ogni vista, { }, sono presenti 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 queste metriche come dimensioni o misure.
Nel seguente esempio di file di visualizzazione, il file orders.view include le definizioni delle dimensioni id, status e user_id, del gruppo di dimensioni created e della misura count:
view: orders {
sql_table_name: demo_db.orders ;;
drill_fields: [id]
dimension: id {
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: status {
type: string
sql: ${TABLE}.status ;;
}
dimension: user_id {
type: number
# hidden: yes
sql: ${TABLE}.user_id ;;
}
dimension_group: created {
type: time
timeframes: [
raw,
time,
date,
week,
month,
quarter,
year
]
sql: ${TABLE}.created_at ;;
}
measure: count {
type: count
drill_fields: [id, users.id, users.first_name, users.last_name, order_items.count]
}
}
La definizione di questi campi nella vista orders mostra i campi Data creazione, ID, Stato, ID utente e Conteggio nel selettore campi per l'esplorazione Ordini.
Gli utenti che hanno accesso all'esplorazione Ordini possono eseguire query sull'esplorazione Ordini selezionando e filtrando questi campi.
Oltre a dimensioni e misure, puoi anche creare diverse dimensioni basate sul tempo contemporaneamente utilizzando i gruppi di dimensioni o specificare un filtro per gli utenti mediante i campi del filtro. Visita la pagina della documentazione Visualizza parametri per saperne di più sui parametri LookML nei file delle viste e la pagina della documentazione Parametri dei campi per informazioni sui parametri LookML utilizzati per definire dimensioni, misure, gruppi di dimensioni e campi filtro in LookML.
File della dashboard
Looker supporta due tipi di dashboard:
- Dashboard definite dall'utente, che possono essere create da utenti non sviluppatori senza utilizzare LookML. Per maggiori dettagli, consulta la pagina della documentazione Creazione di dashboard definite dall'utente.
- Dashboard LookML, che vengono archiviate come file con controllo della versione associati al progetto.
Se il progetto contiene dashboard LookML, verranno definite in file di dashboard dedicati nell'IDE, con estensione .dashboard.lookml.
Per saperne di più sulle dashboard LookML, consulta la pagina della documentazione Creazione di dashboard LookML.
File di documenti
I file di documento di Looker consentono di scrivere documentazione o altre note sul modello dei dati di Looker utilizzando Markdown con stile GitHub. In questo modo, gli utenti potranno acquisire familiarità con l'utilizzo di Looker nella tua organizzazione.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di documenti, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Visualizzazione del documento all'esterno dell'IDE
Per visualizzare un documento al di fuori dell'IDE, cosa che dovrai fare per sfruttare le funzionalità di navigazione descritte in questa pagina, scegli l'opzione Visualizza documento dal menu Visualizza azioni file per il file del documento:
Puoi distribuire l'URL della pagina risultante ad altri utenti in modo che non debbano passare attraverso la sezione per sviluppatori di Looker per raggiungerla.
Aggiunta di una struttura di navigazione al documento
Puoi aggiungere una barra laterale ai file dei documenti in modo che gli utenti possano vedere facilmente la struttura delle informazioni e passare da un documento all'altro.
Per aggiungere la navigazione nella barra laterale di un documento, crea una sezione di navigazione a partire dalla prima riga del documento. Contrassegna l'inizio e la fine della sezione di navigazione con tre trattini (---).
Nella sezione di navigazione puoi utilizzare i seguenti parametri:
navigation
Puoi utilizzare navigation: true in un file di documento per aggiungere la barra laterale di navigazione al documento. Ad esempio, puoi aggiungere il seguente codice all'inizio di un file Markdown:
---
navigation: true
---
Questo codice aggiunge al documento una barra laterale di navigazione con link a tutti i documenti del progetto. Se in un documento includi solo navigation: true, nella barra laterale di quel documento tutti i documenti del progetto saranno elencati in ordine alfabetico per nome file.
Inoltre, potresti scoprire che l'organizzazione in base al nome file in ordine alfabetico non è ideale, oppure potresti avere alcuni documenti che non vuoi visualizzare nella barra di navigazione:
In questo esempio, potresti voler elencare i documenti Documento Uno, Documento due, Documento 3 e Documento 4 in ordine numerico anziché alfabetico, nonché nascondere il documento Non visualizzare dalla barra laterale di navigazione.
Per modificare l'ordine dei documenti nella barra laterale di navigazione o per visualizzare solo un sottoinsieme dei documenti nella barra laterale, puoi utilizzare questo formato:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Ora la navigazione mostrerà solo i file dei documenti da visualizzare in un ordine più logico:
title
Per impostazione predefinita, la barra laterale mostra l'intestazione del documento (se il documento inizia con un'intestazione) o il nome del file del documento se il file non contiene intestazioni. Puoi aggiungere un parametro title nella parte superiore di un documento per modificare la modalità di visualizzazione del documento nelle barre laterali di navigazione:
---
title: New Title for Users
---
Questo titolo verrà utilizzato come testo del link nelle barre laterali di navigazione di tutti i documenti, a meno che non specifichi un label diverso nella sezione di navigazione di un documento.
label
Se vuoi modificare il modo in cui un documento viene elencato nella barra laterale di navigazione, puoi utilizzare i parametri document e label come questo:
---
navigation:
- document_one
- document: document_two
label: Customized Label for Document Two
- document_three
- document_four
---
Il valore label definisce il modo in cui un documento viene visualizzato nella barra di navigazione laterale del documento, anche se il documento a cui fa riferimento ha un proprio parametro title.
L'esempio precedente ha il seguente aspetto nella barra laterale del documento:
section
Se vuoi suddividere la barra laterale di navigazione in sezioni, puoi utilizzare il parametro section in questo modo:
---
navigation:
- document_one
- document_two
- section: My Section Name
- document_three
- document_four
---
In questo esempio, il parametro section aggiunge un'interruzione di sezione e l'intestazione di testo Nome sezione alla barra laterale.
L'intestazione di testo non è un link in sé, non fa riferimento ad alcun file del documento.
File di dati
I file di dati sono file JSON con estensione .json, .topojson o .geojson.
Il parametro map_layer ti consente di utilizzare un file JSON come mappa personalizzata da utilizzare per tracciare i dati in Looker.
Potrai quindi utilizzare il parametro map_layer_name con una dimensione in modo da poter associare un valore di dati (come "Parigi") a una regione geografica sulla tua mappa personalizzata.
Puoi modificare un file JSON nell'IDE LookML e selezionare Salva.
Per il debug, puoi scegliere Visualizza file RAW selezionando il menu Visualizza azioni su file accanto al nome del file per visualizzare il file in formato non elaborato. Se disponi dell'estensione corretta per visualizzare JSON nel browser, avrai anche la possibilità di visualizzare il file in un formato analizzato.
Per istruzioni su come caricare un file JSON in un progetto LookML, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File manifest del progetto
Il progetto potrebbe contenere un file manifest del progetto, utilizzato per le attività seguenti:
- Specifica di altri progetti da importare nel progetto corrente
- Specificare le impostazioni di localizzazione del modello
- Definizione delle costanti LookML
- Aggiunta di un'estensione al progetto
- Aggiunta di una visualizzazione personalizzata al progetto
Ogni progetto può avere un solo file manifest, che deve essere denominato manifest.lkml e trovarsi al livello principale della struttura di directory del progetto e nel repository Git.
Per istruzioni sulla creazione dei file di progetto LookML, inclusi i file manifest del progetto, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File di blocco dei manifest
I file di blocco dei manifest vengono creati automaticamente quando viene aggiunta una dipendenza remota al file manifest del progetto. Looker utilizza il file di blocco del manifest per monitorare la versione dei progetti remoti specificati nel file manifest. Il file di blocco del manifest è elencato nel riquadro del browser di file dell'IDE di Looker e ha il nome file manifest_lock.lkml.
Gli sviluppatori di Looker non devono creare o modificare un file di blocco del manifest, poiché i file di blocco sono gestiti automaticamente da Looker.
Per ulteriori informazioni, consulta la pagina della documentazione Importazione di file da altri progetti.
File di stringhe delle impostazioni internazionali
Se stai localizzando il tuo modello dei dati, dovrai creare file di stringhe delle impostazioni internazionali per ogni lingua in cui vuoi eseguire la localizzazione, incluse quelle predefinite (ad esempio, spesso l'inglese negli Stati Uniti).
I file di stringhe delle impostazioni internazionali elencano le coppie chiave-valore per ogni etichetta e descrizione che localizzi nel modello. Il file di stringhe per ogni lingua dovrebbe fornire la traduzione di quelle impostazioni internazionali per ogni etichetta o descrizione. Per ulteriori informazioni sulla creazione di file di stringhe di impostazioni internazionali, consulta la pagina della documentazione Localizzazione del modello LookML.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di stringhe di impostazioni internazionali, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Esplora file
Un'esplorazione è una vista su cui gli utenti possono eseguire query. Un'esplorazione è il punto di partenza per una query o, in termini SQL, FROM in un'istruzione SQL. Per informazioni su come gli utenti interagiscono con le esplorazioni per eseguire query sui dati, consulta la pagina della documentazione Visualizzazione e interazione con le esplorazioni in Looker.
Le esplorazioni sono in genere definite all'interno di un file del modello. Tuttavia, a volte hai bisogno di un file Esplora separato per una tabella derivata oppure per estendere o perfezionare un'esplorazione nei vari modelli.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di Esplora, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File di test dei dati
Nel progetto potrebbero essere utilizzati file di test dei dati per verificare la logica del modello LookML. I test dei dati possono essere contenuti nei file del modello o nei file delle visualizzazioni, ma se i tuoi sviluppatori vogliono utilizzare gli stessi test sui dati su più modelli diversi, può essere utile conservarli in un file dedicato.
Per istruzioni sulla creazione dei file di progetto LookML, inclusi i file di test dei dati, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File dei perfezionamenti
Il progetto potrebbe utilizzare file per i perfezionamenti LookML. Con i perfezionamenti LookML, puoi adattare una vista o esplorazione esistente senza modificare il file LookML che la contiene. I perfezionamenti LookML possono essere contenuti in file di modello, visualizzazione o esplorazione oppure in file dedicati.
Consulta la pagina della documentazione Gestione di file e cartelle LookML per istruzioni sulla creazione di file di progetto LookML, inclusi i file di perfezionamento.
Altri file
Molti elementi LookML possono essere contenuti in file diversi del tuo progetto o in file dedicati. Ad esempio, i test di dati possono essere ospitati in file di modello, file di visualizzazione o file .lkml dedicati.