Un progetto Looker è una raccolta di file LookML che indicano a Looker come connettersi al tuo database, come eseguire query sui tuoi dati e come controllare il comportamento dell'interfaccia utente. Puoi accedere ai file di progetto LookML dalla sezione Sviluppo in Looker o dall'interfaccia utente, come descritto nella pagina Accesso ai file di progetto LookML.
I file di progetto sono organizzati dagli sviluppatori di Looker utilizzando cartelle nell'IDE.
Un progetto LookML è costituito da almeno un file di modello e da almeno una vista e possibilmente 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 dell'IDE.
Seleziona i seguenti link per ottenere maggiori informazioni su ciascuno dei tipi di file che possono essere utilizzati in un progetto LookML:
- File del modello con estensione
.model.lkml - Visualizza i file con estensione
.view.lkml - File della dashboard con estensione
.dashboard.lookml - File di dati con estensione
.topojson,.geojsono.json - File di documenti con estensione
.md - File manifest del progetto denominati sempre
manifest.lkml - File di blocco manifest con estensione
.lkml - File delle stringhe locali con estensione
.strings.json - Esplora i file con l'estensione
.explore.lkml - File di test dei 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 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 tale connessione. Un file modello definisce anche le esplorazioni e le loro relazioni con 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 Esplora di Looker.
In altre parole, il file modello ti consente di definire le tabelle di dati da utilizzare (come le visualizzazioni incluse) e come devono essere unite, se necessario.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di modello, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Struttura e sintassi generale
All'interno delle parentesi graffe di un'esplorazione, { }, devi definire i parametri per l'esplorazione. Puoi utilizzare i parametri join per unire altre viste a un'esplorazione in un file modello.
Nell'esempio seguente, il codice LookML in un file di modello di esempio definisce un'esplorazione denominata inventory_items, insieme alle 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 gli Elementi 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 relativa ai termini e concetti di LookML.
Per scoprire di più sui parametri LookML nel file del modello, consulta le pagine della documentazione relative ai parametri del modello, Esplora e Unisci parametri.
Visualizza file
In genere un file vista definisce una "visualizzazione" all'interno di Looker. Una vista corrisponde a una singola tabella nel tuo database o a una singola tabella derivata. Il file vista specifica una tabella per la query e i campi (dimensioni e misure) da includere in tale tabella in modo che gli utenti possano creare query con questi campi nell'interfaccia utente di Looker.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di vista, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Struttura e sintassi generale
All'interno delle parentesi graffe di ogni vista, { } sono definizioni di campi, che in genere corrispondono a una colonna nella tabella sottostante o a un calcolo in Looker. Looker classifica quasi tutte le dimensioni: dimensioni o misure.
Nel seguente esempio di file di vista, 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 espone i campi Data di creazione, ID, Stato, ID utente e Conteggio nel selettore campi per l'esplorazione Ordini.
Gli utenti che hanno accesso alla funzionalità Esplora possono eseguire query su Ordini selezionando e filtrando i campi interessati.
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 utilizzando i campi filtro. Per ulteriori informazioni sui parametri LookML nei file delle viste, consulta la pagina della documentazione dedicata ai parametri dei campi e visita la pagina della documentazione relativa ai parametri dei campi per trovare informazioni sui parametri LookML utilizzati per definire dimensioni, misure, gruppi di dimensioni e campi dei filtri in LookML.
File della dashboard
Looker supporta due tipi di dashboard:
- Dashboard definite dall'utente: possono essere create da utenti che non sono sviluppatori senza utilizzare LookML. Per i dettagli, consulta la pagina della documentazione Creazione di dashboard definite dall'utente.
- Dashboard LookML, che vengono memorizzate come file controllati con versione associati al progetto.
Se il tuo progetto contiene dashboard LookML, verranno definite in file di dashboard dedicati nell'IDE, con l'estensione .dashboard.lookml.
Per ulteriori informazioni sulle dashboard LookML, consulta la pagina della documentazione Creazione di dashboard LookML.
File di documenti
I file dei documenti di Looker ti consentono di scrivere documentazione o altre note sul modello dei dati di Looker utilizzando Markdown con aroma GitHub. Questo può essere utile per far conoscere ai tuoi utenti il modo in cui la tua organizzazione utilizza Looker.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file dei documenti, consulta la pagina della documentazione Gestione di file e cartelle LookML.
Visualizzazione del documento al di fuori dell'IDE
Per visualizzare un documento al di fuori dell'IDE, che devi eseguire per usufruire delle funzionalità di navigazione descritte in questa pagina, scegli l'opzione Visualizza documento dal menu Visualizza le azioni relative al file per il file del documento:
Puoi distribuire l'URL della pagina risultante ad altri utenti in modo che non debbano navigare nella sezione per sviluppatori di Looker per raggiungerla.
Aggiungere una struttura di navigazione al documento.
Puoi aggiungere una barra laterale ai file dei documenti per consentire agli utenti di vedere facilmente la struttura delle informazioni e di spostarsi tra i documenti.
Per aggiungere la navigazione laterale per 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 a quel documento. Ad esempio, puoi aggiungere il seguente codice nella parte superiore 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 includi solo navigation: true in un documento, la barra laterale del documento elenca tutti i documenti del progetto in ordine alfabetico in base al nome file.
Inoltre, l'organizzazione in base al nome file alfabetico non è la soluzione ideale o alcuni documenti che non vuoi vengano visualizzati nella navigazione:
In questo esempio, potresti voler elencare i documenti Documento 1, Documento due, Documento tre e Documento quattro in ordine numerico anziché in ordine alfabetico, nonché nascondere il documento Non visualizzare nella barra laterale di navigazione.
Per modificare l'ordine dei documenti nella barra laterale di navigazione o per visualizzare 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 che vengano mostrati e appaiono in ordine più logico:
title
Per impostazione predefinita, nella barra laterale è visualizzata l'intestazione del documento (se il documento inizia con un'intestazione) oppure il nome file del documento se il file non contiene intestazioni. Puoi aggiungere un parametro title nella parte superiore di un documento per modificare il modo in cui il documento viene visualizzato 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 nel seguente modo:
---
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 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 nel seguente 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 stesso, non si riferisce a un 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, che può essere utilizzata per rappresentare graficamente i dati in Looker.
Successivamente, puoi utilizzare il parametro map_layer_name con una dimensione per associare un valore dei dati (come "Parigi") a un'area geografica della tua mappa personalizzata.
Puoi modificare un file JSON nell'IDE LookML e selezionare Salva.
Per il debug, puoi scegliere Visualizza raw selezionando il menu Vedi azioni file accanto al nome del file per visualizzare il file in formato non elaborato. Se disponi dell'estensione appropriata per visualizzare il file 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 Documentazione sulla gestione di file e cartelle LookML.
File manifest del progetto
Il progetto può contenere un file manifest di progetto utilizzato per le seguenti attività:
- Specificare altri progetti da importare nel progetto corrente
- Specificare le impostazioni di localizzazione del modello
- Definizione delle costanti LookML
- Aggiungere 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 deve trovarsi a livello di directory principale della struttura di directory del progetto e nel repository Git.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file manifest dei progetti, consulta la pagina Gestione di file e cartelle LookML.
File di blocco del manifest
I file di blocco manifest vengono creati automaticamente quando viene aggiunta una dipendenza da remoto al file manifest del progetto. Looker utilizza il file manifest di blocco per monitorare la versione dei progetti remoti specificati nel file manifest.
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 stringa internazionali
Se devi localizzare il modello di dati, dovrai creare file di impostazioni internazionali per ogni lingua in cui vuoi eseguire la localizzazione, inclusa la lingua predefinita (ad esempio spesso in inglese negli Stati Uniti).
Nei file delle stringhe internazionali sono elencate le coppie chiave-valore per ogni etichetta e descrizione che vengono localizzate nel modello. Il file di stringhe per ogni lingua deve fornire la traduzione per ciascuna etichetta o descrizione. Per ulteriori informazioni sulla creazione dei file stringa locali, consulta la pagina Localizzazione del modello LookML.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file stringa di impostazioni internazionali, consulta la pagina della documentazione Gestione dei file e delle cartelle LookML.
Esplora file
In genere, le esplorazioni vengono definite all'interno di un file modello. A volte, però, è necessario un file Explore esplicativo per una tabella derivata oppure per estendere o perfezionare un'esplorazione tra i modelli.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di esplorazione, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File di test dei dati
Il tuo progetto potrebbe contenere file di test dei dati utilizzati per verificare la logica del tuo modello LookML. I test di dati possono essere contenuti in file modello o file di vista, ma se gli sviluppatori vogliono utilizzare gli stessi test dei dati in diversi modelli, può essere utile conservarli in un file dedicato.
Per istruzioni sulla creazione di file di progetto LookML, inclusi i file di test dei dati, consulta la pagina della documentazione Gestione di file e cartelle LookML.
File di perfezionamenti
Il tuo progetto potrebbe contenere file utilizzati per i perfezionamenti LookML. Con i perfezionamenti LookML, puoi adattare una vista o un'esplorazione esistente senza modificare il file LookML che la contiene. I perfezionamenti LookML possono essere contenuti in file modello, visualizzazione o esplorazione oppure nel proprio file dedicato.
Consulta la pagina della documentazione Gestione di file e cartelle LookML per le 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 tuo progetto o in file dedicati. Ad esempio, i test dei dati possono essere inseriti in file modello, file di visualizzazione o file .lkml dedicati.