Un progetto LookML è una raccolta di file LookML che indicano a Looker come connettersi al database, come eseguire query sui dati e come controllare il comportamento dell'interfaccia utente. Puoi accedere ai file di progetto LookML dalla sezione Sviluppa in Looker o dall'interfaccia utente, come descritto nella pagina di documentazione Accedere ai file di progetto LookML.
I file di progetto vengono organizzati dagli sviluppatori di Looker utilizzando 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 dell'IDE se il 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 si chiamano sempre
manifest.lkml - File manifest bloccati con estensione
.lkml - File di stringhe delle impostazioni internazionali con estensione
.strings.json - Esplorare i file con estensione
.explore.lkml - File di test dei dati con estensione
.lkml - File di perfezionamento 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 del 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
All'interno delle parentesi graffe di un'esplorazione, { }, definisci i parametri per l'esplorazione. Puoi utilizzare i parametri join per unire altre visualizzazioni a un'esplorazione in un file del modello.
Nell'esempio seguente, il codice LookML in un file modello di esempio definisce un'esplorazione denominata inventory_items, insieme alle relative visualizzazioni 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 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 in 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 visualizzazione.
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. Looker classifica la maggior parte di queste definizioni 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 di creazione, ID, Stato, ID utente e Conteggio nel selettore di 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 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 di LookML, queste verranno definite in file dashboard dedicati nell'IDE, con l'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 possono acquisire familiarità con il modo in cui la tua organizzazione utilizza Looker.
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 al di fuori 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 possano accedere direttamente al documento senza dover navigare nel menu Sviluppa di Looker per raggiungerlo.
Aggiungere una struttura di navigazione al documento
Puoi aggiungere una barra laterale ai file dei documenti in modo che gli utenti possano vedere la struttura delle informazioni e spostarsi tra i documenti.
Per aggiungere la navigazione nella barra laterale per 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 i 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 o potresti avere alcuni documenti che non vuoi che vengano visualizzati 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 dei documenti che vuoi visualizzare 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 modificarne la visualizzazione 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 la modalità di visualizzazione di un documento nella barra laterale di navigazione, 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 come segue:
---
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 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.
Poi utilizzi il parametro map_layer_name con una dimensione per associare un valore di dati (ad es. "Parigi") a una regione geografica sulla 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 appropriata 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
- 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 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 saperne di più, consulta la pagina di documentazione relativa all'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.
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.
Le esplorazioni vengono solitamente 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 di 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 di LookML, puoi adattare una vista o un'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 su come creare 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 in file .lkml dedicati.