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 modello e da almeno un file di vista, oltre che eventualmente da 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 - Visualizzare i 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 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 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 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 di LookML in un file del modello, consulta la pagina della documentazione Terminologia e concetti di LookML.
Per saperne di più sui parametri LookML nel file del modello, leggi le pagine della documentazione Parametri modello, Parametri Esplora 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.
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 le definizioni dei campi, che in genere corrispondono a una colonna della tabella sottostante o a un calcolo in Looker. La maggior parte di queste viene classificata 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 in base a 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 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 di LookML, queste verranno definite in file di dashboard dedicati nell'IDE, con l'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.
Consulta la pagina della documentazione Gestione di file e cartelle LookML per istruzioni sulla creazione di file di progetto LookML, inclusi i file di documento.
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 che inizi dalla prima riga del documento. Segna 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, la barra laterale del documento elenca tutti i documenti del progetto 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 navigazione:
In questo esempio, potresti voler elencare i documenti Documento 1, Documento 2, Documento 3 e Documento 4 in ordine numerico anziché alfabetico, nonché nascondere il documento Non mostrare 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 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 è elencato nella barra laterale di navigazione, puoi utilizzare i parametri document e label come segue:
---
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 del testo non è un link in sé; non fa riferimento a nessuno dei tuoi file di documenti.
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 non elaborato selezionando il menu Visualizza azioni 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, utilizzato per le attività seguenti:
- Specificare altri progetti da importare nel progetto corrente
- Specifica delle impostazioni di localizzazione del modello
- Definizione delle costanti LookML
- Aggiunta di un'estensione al progetto
- Aggiungere 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 di 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 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 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 di documentazione Localizzazione del modello LookML.
Consulta la pagina di documentazione Gestione di file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file di stringhe di impostazioni internazionali.
Esplorare i file
Un'esplorazione è una vista su cui gli utenti possono eseguire query. Un'esplorazione è il punto di partenza di una query o, in termini SQL, il 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.
Consulta la pagina della documentazione Gestione di file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file di esplorazione.
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.
Consulta la pagina di documentazione Gestione di file e cartelle LookML per istruzioni su come creare file di progetto LookML, inclusi i file di test dei dati.
File di perfezionamento
Il progetto potrebbe contenere file utilizzati per i perfezionamenti di 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 inseriti in file diversi del progetto o in file dedicati. Ad esempio, i test dei dati possono essere inseriti in file di modelli, file di visualizzazione o file .lkml dedicati.