I file di progetto LookML sono organizzati in cartelle nella sezione del browser dei file dell'IDE di Looker. Questa pagina fornisce istruzioni per creare e gestire cartelle e file in un progetto LookML.
Per informazioni sulla struttura e sullo scopo di ogni tipo di file in un progetto LookML, consulta la pagina della documentazione Tipi di file in un progetto LookML.
Convenzioni di denominazione importanti per file e cartelle
Quando crei file e cartelle, tieni presente le seguenti convenzioni di denominazione:
- Sensibilità alle maiuscole:LookML fa distinzione tra maiuscole e minuscole. Assicurati di rispettare le convenzioni del progetto quando assegni un nome alle cartelle. Ad esempio, se la tua convenzione prevede l'utilizzo di tutte le lettere minuscole nel progetto, dovresti chiamare la cartella
views
anzichéViews
. Ciò fa la differenza soprattutto quando devi specificare il percorso di un file, ad esempio quando includi file. In generale, è consigliabile utilizzare sempre lettere minuscole quando assegni un nome a oggetti e cartelle LookML. - Spazi e caratteri speciali:i nomi dei file non possono contenere spazi né i seguenti caratteri:
/
?
*
:
|
"
<
>
%
- Estensioni dei file:quando crei file LookML con l'IDE di Looker, Looker aggiunge automaticamente l'estensione
.lkml
alla fine del nome file se non la includi manualmente. Ad esempio, se inserisci il nome fileflights_data_tests
, Looker assegnerà al file il nomeflights_data_tests.lkml
. - Modificare il nome visualizzato di un oggetto LookML:se vuoi modificare il nome visualizzato di un modello o di un oggetto LookML, valuta la possibilità di utilizzare il parametro
label
o il parametroalias
anziché rinominare il file o l'oggetto. I parametrilabel
ealias
modificano il nome visualizzato mantenendo l'URL sottostante utilizzato per le email o altri sistemi. In generale, devi prendere precauzioni per rendere le modifiche al modello il meno invasive possibile. Se devi rinominare un modello o un oggetto, utilizza Content Validator per aggiornare tutti i riferimenti al modello o all'oggetto.
Creare cartelle
Puoi creare cartelle per diversi tipi di file (ad esempio file di visualizzazione o file di modelli). Puoi anche creare sottocartelle, il che è molto utile se vuoi include
un sottoinsieme delle tue visualizzazioni.
Per creare una cartella:
- Seleziona l'opzione Crea cartella dal menu appropriato:
- Per creare una nuova cartella nel livello superiore della struttura di directory, utilizza il menu Aggiungi file o cartella, a cui puoi accedere selezionando l'icona + (più) nella parte superiore del riquadro Esplora file.
- Per creare una nuova sottocartella in una cartella esistente, utilizza il menu con tre puntini Opzioni cartella per la cartella esistente.
- Inserisci un nome per la nuova cartella.
- Seleziona Crea.
La nuova cartella viene aggiunta al riquadro di navigazione.
Creazione dei file
Looker crea automaticamente un file modello e file di visualizzazione basati sul tuo database quando generi un modello. Per i progetti esistenti, puoi creare manualmente nuovi file.
Per creare un nuovo file nel progetto LookML:
Seleziona il menu appropriato:
- Per creare un nuovo file nel livello superiore della struttura di directory, utilizza il menu Aggiungi file o cartella, a cui puoi accedere selezionando l'icona + (più) nella parte superiore del riquadro Browser file.
- Per creare un nuovo file in una cartella esistente, utilizza il menu con tre puntini Opzioni cartella per la cartella esistente.
Seleziona il tipo di file LookML che vuoi creare. Seleziona i link nel seguente elenco per una descrizione più dettagliata di ciascun tipo di file. Puoi creare i seguenti tipi di file:
- File del modello con l'estensione
.model.lkml
- Visualizza i file con l'estensione
.view.lkml
(per saperne di più, consulta la sezione Considerazioni per la creazione di file di visualizzazione) - File manifest del progetto, sempre denominati
manifest.lkml
(per maggiori informazioni, consulta la sezione Considerazioni per la creazione dei file) - File della dashboard con l'estensione
.dashboard.lookml
- File di documenti con l'estensione
.md
- File di stringhe di località con l'estensione
.strings.json
(per ulteriori informazioni, consulta la sezione Considerazioni per la creazione di file) - File LookML generici, utilizzati per i seguenti tipi di file:
- Esplora i file con l'estensione
.explore.lkml
(per ulteriori informazioni, consulta la sezione Considerazioni per la creazione di file) - File di test dei dati con l'estensione
.lkml
- File di perfezionamento con l'estensione
.lkml
- Qualsiasi altro file che utilizzi per ospitare elementi LookML
- Esplora i file con l'estensione
- File del modello con l'estensione
Nella finestra di dialogo Crea file, inserisci un nome per il nuovo file. Consulta la sezione Convenzioni di denominazione importanti per file e cartelle per conoscere limitazioni e linee guida per la denominazione dei file.
Seleziona Crea. Il nuovo file verrà visualizzato nella posizione in cui l'hai creato. Se necessario, puoi spostarlo in un'altra cartella.