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 avere ulteriori informazioni su ciascuno dei tipi di file che possono essere utilizzati in un progetto LookML:
- File modello con estensione
.model.lkml - Visualizzare i file con estensione
.view.lkml - File della dashboard con estensione
.dashboard.lookml - File di dati con estensione
.topojsono.geojsono.json - File di documenti con estensione
.md - File manifest del progetto che hanno sempre il nome
manifest.lkml - File manifest bloccati con estensione
.lkml - File di stringhe delle impostazioni internazionali 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 non elencata in precedenza
Dopo aver creato un progetto LookML, puoi accedere ai file del progetto e aggiungere nuovi file e cartelle al progetto utilizzando l'IDE di Looker.
File del modello
Un file modello specifica una connessione al database e l'insieme di esplorazioni che utilizzano la connessione. Un file modello definisce anche le esplorazioni stesse e le loro relazioni con altre visualizzazioni. 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 quando aprono il menu Esplora di Looker.
In altre parole, nel file modello definisci quali tabelle di dati devono essere utilizzate (come visualizzazioni incluse) e come devono essere unite, se necessario.
Consulta la pagina di documentazione Gestire file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file modello.
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 di LookML fa sì che Elementi inventario venga visualizzato nella sezione Esplora della navigazione di Looker e unisce i dati delle visualizzazioni products e distribution_centers alla visualizzazione 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 scoprire di più sui parametri LookML nel file del modello, consulta le pagine di documentazione Parametri del modello, Parametri di esplorazione e Parametri di join.
Visualizza file
In genere, un file di visualizzazione definisce una singola "visualizzazione" in Looker. Una vista corrisponde a una singola tabella nel database o a una singola tabella derivata. Il file della visualizzazione specifica una tabella su cui eseguire query e i campi (dimensioni e misure) da includere da quella tabella in modo che gli utenti possano creare query con questi campi nell'interfaccia utente di Looker.
Consulta la pagina della documentazione Gestione di file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file di vista.
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 per le dimensioni id, status e user_id, il gruppo di dimensioni created e la 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 alle dimensioni e alle misure, puoi anche creare più dimensioni basate sul tempo contemporaneamente utilizzando i gruppi di dimensioni o specificare un filtro per gli utenti con i campi di filtro. Per scoprire di più sui parametri LookML nei file di visualizzazione, consulta la pagina della documentazione Parametri di visualizzazione e, per informazioni sui parametri LookML utilizzati per definire dimensioni, misure, gruppi di dimensioni e campi di filtro in LookML, consulta la pagina della documentazione Parametri di campo.
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, archiviate come file con controllo delle versioni associati al progetto.
Se il progetto contiene dashboard LookML, verranno definite in file di dashboard dedicati nell'IDE, con estensione .dashboard.lookml.
Per ulteriori informazioni sulle dashboard di LookML, consulta la pagina della documentazione Creare dashboard di LookML.
File di documenti
I file di documenti di Looker ti consentono di scrivere documentazione o altre note sul tuo modello di 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 all'esterno dell'IDE, che dovrai fare per sfruttare le funzionalità di navigazione descritte in questa pagina, scegli l'opzione Visualizza documento dal menu Azioni di visualizzazione file per il file del documento:
Puoi distribuire l'URL della pagina risultante ad altri utenti in modo che non debbano accedere alla 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 spostarsi tra i documenti.
Per aggiungere la navigazione nella barra laterale di un documento, crea una sezione di navigazione che inizi 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 i 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 del file in ordine alfabetico non è ideale o potresti avere alcuni documenti che non vuoi che vengano visualizzati nella 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 mostrare solo un sottoinsieme di documenti nella barra laterale, puoi utilizzare questo formato:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Ora la navigazione mostrerà solo i file di documenti che vuoi che vengano visualizzati e questi verranno visualizzati 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 se non è presente alcuna intestazione nel file. 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 una interruzione di sezione e l'intestazione di testo Nome della mia sezione alla barra laterale.
L'intestazione di testo non è un link in sé; non fa riferimento a nessuno dei tuoi file di 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 che può essere utilizzata 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 il 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, che viene utilizzato per le seguenti attività:
- Specificare altri progetti da importare nel progetto corrente
- Specificare le impostazioni di localizzazione del modello
- Definizione delle costanti di 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 a livello di root nella struttura di directory del progetto e nel repository Git.
Consulta la pagina della documentazione Gestire file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file manifest del progetto.
File di blocco 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 manifest per monitorare la versione dei progetti remoti specificati nel file manifest. Il file di blocco 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 manifest, poiché i file di blocco vengono 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 di dati, devi creare file di stringhe internazionali per ogni lingua in cui vuoi eseguire la localizzazione, inclusa quella predefinita (ad esempio, spesso l'inglese negli Stati Uniti).
I file di stringhe di impostazioni internazionali elencano le coppie chiave-valore per ogni etichetta e descrizione che stai localizzando nel modello. Il file strings per ogni lingua deve fornire la traduzione della lingua per ogni etichetta o descrizione. Ulteriori informazioni sulla creazione di file di stringhe di impostazioni internazionali sono disponibili nella 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.
Esplorare i 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 Visualizzare ed eseguire interazioni con le esplorazioni in Looker.
In genere le esplorazioni vengono definite all'interno di un file del modello. Tuttavia, a volte è necessario un file di esplorazione separato per una tabella derivata o per estendere o perfezionare un'esplorazione in più 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
Il progetto potrebbe contenere file di test sui dati utilizzati per verificare la logica del modello LookML. I test sui dati possono essere contenuti in file di modelli o in file di visualizzazioni, ma se gli sviluppatori vogliono utilizzare gli stessi test sui dati in 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 di perfezionamento
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 di LookML possono essere contenuti in file di modelli, viste o esplorazioni oppure in un file dedicato.
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.