Gestione di file e cartelle LookML

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 ciascun tipo di file in un progetto LookML, consulta la pagina della documentazione Tipi di file in un progetto LookML.

Prima di iniziare: convenzioni di denominazione importanti per file e cartelle

Quando crei file e cartelle, è meglio tenere presenti le seguenti convenzioni di denominazione:

• Sensibilità alle maiuscole: LookML è sensibile alle maiuscole. Assicurati di rispettare le convenzioni del progetto quando assegni un nome alle cartelle. Ad esempio, se la convenzione è utilizzare tutte le lettere minuscole nel progetto, ti consigliamo di assegnare alla cartella il nome views anziché Views. Questo fa la differenza soprattutto quando devi specificare il percorso di un file, ad esempio quando includi file. In genere, è buona norma utilizzare sempre lettere minuscole per assegnare nomi a cartelle e oggetti LookML.
• Spazi e caratteri speciali: i nomi dei file non possono contenere spazi né i seguenti caratteri: / ? * : | " < > %
• Estensioni 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 file flights_data_tests, Looker lo chiamerà flights_data_tests.lkml.
• Modifica del nome visualizzato di un oggetto LookML: se vuoi modificare il nome visualizzato di un modello o di un oggetto LookML, ti consigliamo di utilizzare il parametro label o il parametro alias anziché rinominare il file o l'oggetto. I parametri label e alias modificano il nome visualizzato mantenendo l'URL sottostante utilizzato per le email o altri sistemi. In generale, devi adottare precauzioni per apportare modifiche al modello il meno invasive possibile. Se devi rinominare un modello o un oggetto, utilizza lo strumento Content Validator per aggiornare tutti i riferimenti al modello o all'oggetto.

Creazione di cartelle

Puoi creare cartelle per diversi tipi di file (ad esempio file di visualizzazione o file di modello). Puoi anche creare sottocartelle, il che è molto utile se vuoi include un sottoinsieme delle tue visualizzazioni.

Nota: quando crei cartelle, tieni presente che LookML è sensibile alle maiuscole. Assicurati di rispettare le convenzioni del progetto quando assegni un nome alle cartelle. Questo è importante, in particolare quando devi specificare il percorso di un file, ad esempio quando includi file. In genere, è buona norma utilizzare sempre lettere minuscole per assegnare nomi a cartelle e oggetti LookML. Consulta le note importanti per la creazione di file e cartelle per conoscere le limitazioni e le linee guida per la denominazione di file e cartelle.

Per creare una cartella:

1. Seleziona l'opzione Crea cartella dal menu appropriato:
   • Per creare una nuova cartella al livello superiore della struttura della directory, utilizza il menu Aggiungi file o cartella, a cui puoi accedere selezionando l'icona + (più) nella parte superiore del riquadro File Browser.
   • Per creare una nuova sottocartella in una cartella esistente, utilizza il menu Opzioni cartella con tre puntini per la cartella esistente.
2. Inserisci un nome per la nuova cartella.
3. Seleziona Crea.

La nuova cartella viene aggiunta al riquadro di navigazione.

Creazione dei file

Quando generi un modello, Looker crea automaticamente un file del modello e i file delle visualizzazioni in base al tuo database. Per i progetti esistenti, puoi creare nuovi file manualmente.

Nota: ti consigliamo di utilizzare l'IDE di Looker per aggiungere file al tuo progetto LookML, creandoli nell'IDE di Looker come descritto più avanti in questa sezione o caricandoli nell'IDE di Looker. Se invece crei file al di fuori dell'IDE di Looker e poi utilizzi l'IDE di Looker per eseguire il pull da (ramo di produzione), assicurati di utilizzare le convenzioni di denominazione corrette e di includere l'estensione .lkml nel nome del file (o explore.lkml per i file di esplorazione). Se un nome file include caratteri non supportati, il browser di file di Looker IDE lo mostrerà in rosso e non potrai vedere i contenuti del file finché non lo rinomini con caratteri supportati. Inoltre, l'IDE di Looker non mostrerà il file se non ha l'estensione .lkml.

Per creare un nuovo file nel progetto LookML:

1. Seleziona il menu appropriato:

   • Per creare un nuovo file al livello superiore della struttura della directory, utilizza il menu Aggiungi file o cartella, a cui puoi accedere selezionando l'icona + (più) nella parte superiore del riquadro File Browser.
   • Per creare un nuovo file in una cartella esistente, utilizza il menu Opzioni cartella con tre puntini per la cartella esistente.

2. Seleziona il tipo di file LookML da 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 modello con estensione .model.lkml
   • Visualizzare i file con l'estensione .view.lkml*
   • File manifest del progetto che si chiamano sempre manifest.lkml**
   • File della dashboard con estensione .dashboard.lookml
   • File di documenti con estensione .md
   • File di stringhe delle impostazioni internazionali con l'estensione .strings.json***
   • File LookML generici, utilizzati per i seguenti tipi di file:
     • Esplorare i file con l'estensione .explore.lkml****
     • File di test dei dati con l'estensione .lkml
     • File di perfezionamento con estensione .lkml
     • Eventuali altri file utilizzati per contenere gli elementi LookML
   Nota:

   ^* Consulta la sezione Considerazioni per la creazione di file di visualizzazione in questa pagina per istruzioni su metodi alternativi per la creazione di file di visualizzazione, incluse istruzioni per l'aggiunta di file di visualizzazione in base alle tabelle di database.

   ^** I file manifest del progetto possono essere creati solo selezionando l'icona + (più) per aprire il menu Aggiungi file o cartella nella parte superiore del browser dei file nell'IDE di Looker e solo se il progetto non ha già un file manifest. Questo perché un progetto può avere un solo file manifest e questo deve trovarsi a livello di radice della struttura di directory del progetto.

   ^*** L'opzione Crea file di stringhe di impostazioni internazionali è disponibile solo dall'icona Aggiungi file o cartella + (più) nella parte superiore del browser dei file nell'IDE di Looker, ma una volta creato (o caricato) un file di stringhe di impostazioni internazionali, puoi spostare il file in una cartella. Se stai creando file di stringhe di impostazioni internazionali per localizzare il tuo modello e vuoi anche sfruttare la localizzazione dell'interfaccia utente nativa di Looker, devi assegnare ai file di stringhe nomi utilizzando codici internazionali specifici che puoi trovare nella sezione Impostazioni internazionali della pagina della documentazione Utenti.

   ^**** Quando crei un file di esplorazione, il file deve avere l'estensione .explore.lkml alla fine del nome file. Se carichi il file, devi utilizzare l'estensione .explore.lkml completa. Se utilizzi l'IDE di Looker per creare il file con l'opzione File generici LookML, Looker aggiungerà .lkml alla fine del nome file se l'estensione non è presente, ma dovrai comunque aggiungere manualmente la parte .explore dell'estensione al nome file. Ad esempio, per creare un file di esplorazione denominato flights utilizzando l'IDE di Looker, puoi inserire flights.explore o flights.explore.lkml e il file verrà denominato flights.explore.lkml.

3. Nel popup Crea file, inserisci un nome per il nuovo file. Consulta le note importanti per la creazione di file e cartelle per conoscere le limitazioni e le linee guida per la denominazione dei file.

4. Seleziona Crea. Il nuovo file verrà visualizzato nel punto in cui lo hai creato. Se necessario, puoi spostarlo facilmente in un'altra cartella.

Importante: dopo aver creato il file, assicurati di utilizzare il parametro include se vuoi fare riferimento agli elementi del file in altri file LookML del tuo progetto. Per ulteriori informazioni, consulta la pagina della documentazione del parametro include.

Nota: se l'amministratore di Looker ha attivato la funzionalità di Labs Generare LookML dal database, nel menu Aggiungi file o cartella + (più) nella parte superiore del riquadro File Browser verrà visualizzata un'opzione per Genera LookML dal database, oltre alle opzioni elencate qui.

Considerazioni per la creazione di file di vista

La maggior parte degli sviluppatori LookML inizia con uno o più file di vista che vengono creati automaticamente quando il progetto LookML viene generato da un insieme di tabelle in un database. Tuttavia, oltre ai metodi descritti in questa pagina per creare file di visualizzazione vuoti e per caricare file, esistono molti modi in cui uno sviluppatore Looker in modalità di sviluppo può aggiungere file di visualizzazione a un progetto LookML:

• Creazione di file di vista in base alle tabelle di un database:

  • Generazione di file di vista dalle tabelle del database al primo collegamento al database, come descritto nella pagina di documentazione Generare un modello LookML
  • Generazione di file di visualizzazione dalle tabelle di database per un progetto già collegato a un database, come descritto nella sezione Aggiunta di una nuova visualizzazione da una tabella di database esistente di questa pagina

• Creazione di un file di visualizzazione per una tabella derivata:

  • Partendo da un file di visualizzazione vuoto utilizzando una delle opzioni descritte in questa pagina e poi definendo manualmente la tabella derivata, come descritto nella sezione Definire una tabella derivata nativa in LookML della pagina di documentazione Creare tabelle derivate native
  • Consenti a Looker di creare il codice LookML della tabella derivata da un'esplorazione, come descritto nella sezione Utilizzare un'esplorazione per iniziare a definire le tabelle derivate native della pagina della documentazione Creare tabelle derivate native
  • Chiedere a Looker di creare la tabella LookML derivata da una query di SQL Runner, come descritto nella pagina della documentazione Utilizzare SQL Runner per creare tabelle derivate

Per utilizzare una nuova visualizzazione, aggiungila al file del modello utilizzando il parametro explore oppure utilizza il parametro join per unire la visualizzazione a un'esplorazione esistente nel file del modello.

Aggiunta di una nuova visualizzazione da una tabella di database esistente

Puoi creare un file di visualizzazione da una tabella di database esistente in modalità di sviluppo.

1. All'interno di un progetto, seleziona il menu Aggiungi file o cartella selezionando il segno + (più) nella parte superiore dell'elenco dei file del progetto nell'IDE di Looker oppure puoi selezionare il menu di una cartella per creare il file all'interno della cartella.

2. Seleziona Crea visualizzazione da tabella.

3. Looker mostra un elenco di tabelle associate a una delle tue connessioni. Per modificare la connessione, utilizza il menu a discesa Connessione in alto a sinistra.

4. Seleziona le tabelle da cui vuoi creare visualizzazioni selezionando la casella a sinistra del nome della tabella. Puoi comprimere ed espandere i database o gli schemi in questo elenco per accedere a tutte le tabelle disponibili.

5. Scorri fino in fondo alla pagina e seleziona Crea visualizzazioni.

6. Looker genera visualizzazioni contenenti LookML per tutte le colonne della tabella.

Caricamento di file

Puoi anche caricare file nel progetto dal computer. Questa opzione è utile se hai creato file di dati JSON o file LookML localmente sul computer.

Nota: consulta le note importanti per la creazione di file e cartelle per conoscere le limitazioni e le linee guida per la denominazione dei file.

Per caricare un file nel progetto, utilizza la funzionalità di trascinamento nell'IDE di Looker:

1. Vai ai file del progetto.
2. Trascina il file dal tuo computer nell'IDE di Looker. Il file verrà visualizzato nella directory principale della struttura.
3. Una volta caricato il file, sposta l'elemento in un'altra cartella.

Importante: dopo aver caricato il file, assicurati di utilizzare il parametro include se vuoi fare riferimento al file o agli elementi del file in altri file LookML del tuo progetto. Per ulteriori informazioni, consulta la pagina della documentazione del parametro include.

Eliminazione di file e cartelle

Elimina una cartella o un file selezionando Elimina dal menu Opzioni file con tre puntini dell'elemento nel riquadro a sinistra dell'IDE.

Nota: l'eliminazione di una cartella comporta anche l'eliminazione dei relativi contenuti, quindi fai attenzione quando elimini le cartelle. Prima di eliminare una cartella, segui questi passaggi:

• Verifica di voler eliminare i file nella cartella o spostarli in un'altra posizione prima di eliminare la cartella.
• Verifica che la cartella non contenga file a cui viene fatto riferimento nelle istruzioni include del progetto. Per informazioni sull'utilizzo di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE della pagina della documentazione del parametro include.

Quando elimini una cartella, l'IDE mostra un popup di conferma. Il popup specifica il numero di elementi inclusi nell'eliminazione, tra cui la cartella e tutti i file al suo interno.

Nota: se elimini un file del modello, il modello non viene rimosso dagli insiemi di modelli a cui apparteneva. Se viene creato un nuovo file modello con lo stesso nome di un modello eliminato, il nuovo modello viene incluso in tutti gli insiemi di modelli che includevano il modello eliminato. Ciò può comportare l'accesso indesiderato al file del nuovo modello. Per evitare questo problema, gli amministratori di Looker possono modificare gli insiemi di modelli e rimuovere un modello eliminato.

Eliminare più file e cartelle contemporaneamente

Per eliminare più cartelle e file contemporaneamente:

Nota: l'eliminazione di una cartella comporta l'eliminazione di tutti i relativi contenuti. Prima di eliminare una cartella, verifica di voler eliminare i file al suo interno. Se vuoi conservarli, sposta i file in un'altra posizione prima di eliminare la cartella.

1. Seleziona l'icona Modifica collettiva nella parte superiore del riquadro File Browser.

   

2. Seleziona gli elementi da eliminare. Il numero di file selezionati viene visualizzato accanto all'intestazione Seleziona file.

   

   • Per selezionare o deselezionare i singoli file, espandi le relative cartelle e seleziona la casella di controllo accanto ai nomi file.
   • Per selezionare o deselezionare intere cartelle e i relativi contenuti, seleziona la casella di controllo accanto al nome della cartella.
   • Per selezionare un'intera sezione dell'elenco della directory, usa Shift-clic. Seleziona la casella di controllo dell'elemento superiore dell'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo dell'ultimo elemento dell'elenco. Verranno selezionati entrambi gli elementi e tutti gli elementi intermedi. Puoi anche fare clic con Shift su un elemento per selezionarlo e tutto ciò che si trova sopra nell'elenco della directory.

3. Seleziona l'icona del cestino Elimina elementi. L'IDE mostrerà un menu popup che elenca gli elementi selezionati.

   

4. Conferma gli elementi da eliminare selezionando Sì, elimina oppure torna alla selezione degli elementi selezionando Annulla.

5. Seleziona la X nell'intestazione Seleziona file per uscire dalla modalità di modifica collettiva.

Spostare elementi in un progetto con cartelle

Per spostare i file, trascina un file o una cartella in un'altra cartella.

La cartella di destinazione non deve essere espansa per ricevere altre cartelle o altri file. Una cartella si espande automaticamente quando passi il mouse sopra.

Nota: quando modifichi il percorso di un file, assicurati di aggiornare eventuali istruzioni include nel progetto in modo che corrispondano al nuovo percorso del file. Per informazioni sull'utilizzo di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE della pagina della documentazione del parametro include.

Inoltre, tieni presente che quando modifichi il percorso di un file, Git lo elimina effettivamente e ne crea uno nuovo con il nuovo percorso. Ciò significa che la cronologia Git per il file sarà vuota, perché Git lo considera un nuovo file. Per visualizzare la cronologia Git del file prima che venga spostato, utilizza l'interfaccia Git per accedere al file nella posizione originale e visualizzare la cronologia Git da lì. La stessa logica si applica a un file rinominato, poiché Git lo elimina effettivamente e ne crea uno nuovo con un nome diverso.

Spostare più file e cartelle contemporaneamente

Per spostare più file e cartelle contemporaneamente:

1. Seleziona l'icona Modifica collettiva nella parte superiore del riquadro File Browser.

   

2. Seleziona gli elementi da spostare. Il numero di file selezionati viene visualizzato accanto all'intestazione Seleziona file.

   

   • Per selezionare o deselezionare i singoli file, espandi le relative cartelle e seleziona la casella di controllo accanto ai nomi file.
   • Per selezionare o deselezionare intere cartelle e i relativi contenuti, seleziona la casella di controllo accanto al nome della cartella.
   • Per selezionare un'intera sezione dell'elenco della directory, usa Shift-clic. Seleziona la casella di controllo dell'elemento superiore dell'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo dell'ultimo elemento dell'elenco. Verranno selezionati entrambi gli elementi e tutti gli elementi intermedi. Puoi anche fare clic con Shift su un elemento per selezionarlo e tutto ciò che si trova sopra nell'elenco della directory.

3. Seleziona l'icona della cartella Sposta elementi per selezionare l'opzione. L'IDE mostrerà un menu popup per la selezione della cartella.

   

4. Nel menu popup Sposta in, scegli una cartella per gli elementi selezionati o seleziona Nuova cartella per crearne una nuova. Il nome del progetto mostrerà il percorso del file della cartella selezionata nella parte superiore della pagina del menu successiva. Per spostare gli elementi nella directory principale del progetto, seleziona Sposta senza selezionare una cartella.

5. Conferma la destinazione selezionata selezionando Sposta, crea una nuova cartella all'interno della cartella selezionata selezionando Nuova cartella o torna al menu delle opzioni della cartella principale selezionando il link al nome del progetto nel percorso del file.

6. Seleziona la X nell'intestazione Seleziona file per uscire dalla modalità di modifica collettiva.

Nota: dopo aver modificato il percorso di un file, assicurati di aggiornare eventuali istruzioni include nel progetto in modo che corrispondano al nuovo percorso del file. Per informazioni sull'utilizzo di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE della pagina della documentazione del parametro include.

Inoltre, tieni presente che quando modifichi il percorso di un file, Git lo elimina effettivamente e ne crea uno nuovo con il nuovo percorso. Ciò significa che la cronologia Git per il file sarà vuota, perché Git lo considera un nuovo file. Per visualizzare la cronologia Git del file prima che venga spostato, utilizza l'interfaccia Git per accedere al file nella posizione originale e visualizzare la cronologia Git da lì. La stessa logica si applica a un file rinominato, poiché Git lo elimina effettivamente e ne crea uno nuovo con un nome diverso.