Gestione di file e cartelle LookML

I file di progetto LookML sono organizzati in cartelle nella sezione del browser di file dell'IDE di Looker. Questa pagina fornisce le 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.

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

Quando crei file e cartelle, è bene seguire le seguenti convenzioni di denominazione:

• Sensibilità alle maiuscole: LookML fa distinzione tra maiuscole e minuscole. Assicurati di seguire le convenzioni del tuo progetto quando assegni un nome alle cartelle. Ad esempio, se la tua convenzione è utilizzare tutte le lettere minuscole nel tuo progetto, dovrai assegnare alla cartella il nome views anziché Views. Questo fa la differenza, soprattutto quando è necessario specificare il percorso di un file, ad esempio quando sono inclusi dei file. In genere, è consigliabile utilizzare in modo coerente lettere minuscole quando assegni nomi a cartelle e oggetti LookML.
• Spazi e caratteri speciali: i nomi dei file non possono includere spazi o uno qualsiasi dei seguenti caratteri: / ? * : | " < > %
• Estensioni dei file:quando crei file LookML con l'IDE di Looker, Looker aggiungerà automaticamente l'estensione .lkml alla fine del nome del file, se non la includi manualmente. Ad esempio, se inserisci il nome file flights_data_tests, Looker assegna al file il nome 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, valuta la possibilità di utilizzare il parametro label o 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, dovresti prendere precauzioni per apportare modifiche al modello il più non invasive possibile. Se devi rinominare un modello o un oggetto, utilizza lo Strumento di convalida dei contenuti 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 modello). Puoi anche creare sottocartelle, una soluzione molto utile se vuoi include un sottoinsieme delle tue viste.

Nota: quando crei cartelle, tieni presente che LookML fa distinzione tra maiuscole e minuscole. Assicurati di seguire le convenzioni del tuo progetto quando assegni un nome alle cartelle. Questo è importante, soprattutto quando è necessario specificare il percorso di un file, ad esempio quando sono inclusi dei file. In genere, è consigliabile utilizzare in modo coerente lettere minuscole quando assegni 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 l'assegnazione di nomi a file e cartelle.

Per creare una cartella:

1. Seleziona l'opzione Crea cartella dal menu appropriato:
   • Per creare una nuova cartella al livello principale della struttura della 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 una nuova sottocartella in una cartella esistente, utilizza il menu con tre puntini Opzioni cartella 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 crei un nuovo progetto, puoi generare automaticamente un file del modello e visualizzare i file in base al tuo database. Per i progetti esistenti, puoi creare manualmente nuovi file.

Nota: ti consigliamo di utilizzare l'IDE Looker per aggiungere file al tuo progetto LookML creandoli nell'IDE Looker come descritto di seguito 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 file (o explore.lkml per i file di esplorazione). Se un nome file include caratteri non supportati, il browser di file dell'IDE di Looker mostrerà il nome del file in rosso e non potrai visualizzarne i contenuti finché non rinomini il file con i caratteri supportati. Inoltre, l'IDE di Looker non visualizzerà il file se non ha l'estensione .lkml.

Per creare un nuovo file nel tuo progetto LookML:

1. Seleziona il menu appropriato:

   • Per creare un nuovo file al livello principale della struttura della 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.

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 del modello con l'estensione del file .model.lkml
   • Visualizza i file con l'estensione .view.lkml*
   • File manifest di progetto che vengono sempre denominati manifest.lkml**
   • File di dashboard con l'estensione del file .dashboard.lookml
   • File di documento con l'estensione del file .md
   • File di stringhe locali con estensione .strings.json***
   • File LookML generici, utilizzati per i seguenti tipi di file:
     • Esplora i file con l'estensione .explore.lkml****
     • File di test dei dati con estensione .lkml
     • Perfeziona i file con l'estensione .lkml
     • Qualsiasi altro file utilizzato per ospitare elementi LookML
   Nota:

   ^* Consulta la sezione Considerazioni per la creazione di file di visualizzazione in questa pagina per istruzioni sui metodi alternativi per creare file di visualizzazione, incluse le istruzioni per aggiungere file di visualizzazione basati su 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 di file nell'IDE Looker e solo se il progetto non dispone già di un file manifest. Questo perché un progetto può avere un solo file manifest, che deve trovarsi al livello principale della struttura di directory del progetto.

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

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

3. Nella finestra 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 l'assegnazione di nomi ai file.

4. Seleziona Crea. Il nuovo file verrà visualizzato dove è stato 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 a elementi del file in altri file LookML del tuo progetto. Per saperne di più, consulta la pagina della documentazione sui parametri include.

Nota: se l'amministratore di Looker ha abilitato la funzionalità di Labs Generazione LookML migliorata, il menu Aggiungi file o cartella + (più) nella parte superiore del riquadro Browser file mostrerà un'opzione per Generare LookML dal database oltre alle opzioni elencate qui.

Considerazioni sulla creazione dei file delle viste

La maggior parte degli sviluppatori LookML inizia con uno o più file di visualizzazione che vengono creati automaticamente quando il progetto LookML viene generato da un set di tabelle in un database. Tuttavia, oltre ai metodi descritti in questa pagina per creare file di visualizzazione vuoti e 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 visualizzazione basati su tabelle in un database:

  • Generare file di vista dalle tabelle del database quando ti connetti per la prima volta al tuo database, come descritto nella pagina della documentazione Generazione di un modello
  • Generazione di file delle viste dalle tabelle di database per un progetto già connesso a un database, come descritto nella sezione Aggiunta di una nuova vista da una tabella di database esistente di questa pagina

• Crea un file di visualizzazione per una tabella derivata:

  • Iniziare con un file di visualizzazione vuoto utilizzando una delle opzioni descritte in questa pagina e quindi definire manualmente la tabella derivata, come descritto nella sezione Definizione di una tabella derivata nativa in LookML della pagina della documentazione Creazione di tabelle derivate native
  • Fare in modo che Looker crei il 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 Creazione di tabelle derivate native
  • Chiedere a Looker di creare il LookML della tabella derivata da una query SQL Runner, come descritto nella pagina della documentazione Utilizzo di SQL Runner per creare tabelle derivate

Per utilizzare una nuova vista, aggiungila al file del modello con il parametro explore oppure utilizza il parametro join per unirla a un'esplorazione esistente nel file del modello.

Aggiunta di una nuova vista 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ù) in cima all'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 visualizza 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. Scegli le tabelle da cui vuoi creare le viste selezionando la casella a sinistra del nome della tabella. Puoi comprimere ed espandere i database o gli schemi di questo elenco per accedere a tutte le tabelle disponibili.

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

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

Caricamento di file

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

Nota: consulta le note importanti per la creazione di file e cartelle per conoscere le limitazioni e le linee guida per l'assegnazione di nomi ai file.

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

1. Passa ai file di progetto.
2. Trascina il file dal computer nell'IDE Looker. Il file verrà visualizzato nella directory principale della struttura della directory.
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 saperne di più, consulta la pagina della documentazione relativa al parametro include.

Eliminazione di file e cartelle

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

Nota: se elimini una cartella, ne elimini anche il contenuto, quindi fai attenzione quando elimini le cartelle. Prima di eliminare una cartella, segui questi passaggi:

• Verifica di voler eliminare i file al suo interno o spostali in una posizione diversa prima di eliminare la cartella.
• Verifica che la cartella non contenga file a cui viene fatto riferimento nelle istruzioni include del tuo progetto. Per informazioni sull'uso di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE della pagina della documentazione relativa al parametro include.

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

Nota: se elimini un file modello, quest'ultimo non viene rimosso da nessun set di modelli a cui apparteneva. Se viene creato un nuovo file del modello con lo stesso nome di un modello eliminato, il nuovo modello viene incluso in tutti i set di modelli che includevano il modello eliminato. Ciò può causare l'accesso indesiderato al nuovo file del modello. Gli amministratori di Looker possono modificare i set di modelli e rimuovere un modello eliminato per evitare questo problema.

Eliminazione collettiva di file e cartelle

Per eliminare cartelle e file collettivamente:

Nota: l'eliminazione di una cartella ne comporta l'eliminazione di tutti i 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 di modifica collettiva nella parte superiore del riquadro Browser file.

   

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

   

   • Per selezionare o deselezionare singoli file, espandi le cartelle corrispondenti e seleziona la casella di controllo accanto ai nomi dei 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 di directory, premi Shift e fai clic. Seleziona la casella di controllo relativa all'elemento in cima all'intervallo, tieni premuto il tasto Shift e seleziona la casella di controllo relativa all'ultimo elemento dell'elenco. Verranno selezionati entrambi gli elementi, sia quelli intermedi. Puoi anche fare clic con il tasto Shift su un elemento per selezionare l'elemento e tutti gli elementi al di sopra nell'elenco di directory.

3. Seleziona l'icona del cestino Elimina elementi. L'IDE mostrerà un menu popup con l'elenco degli 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.

Spostamento di elementi in un progetto in cartella

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

Non è necessario espandere la cartella di destinazione per ricevere altre cartelle o altri file. Una cartella si espande automaticamente quando ci passi il mouse sopra.

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

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

Spostare file e cartelle contemporaneamente

Per spostare cartelle e file collettivamente:

1. Seleziona l'icona di modifica collettiva nella parte superiore del riquadro Browser file.

   

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

   

   • Per selezionare o deselezionare singoli file, espandi le cartelle corrispondenti e seleziona la casella di controllo accanto ai nomi dei 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 di directory, premi Shift e fai clic. Seleziona la casella di controllo relativa all'elemento in cima all'intervallo, tieni premuto il tasto Shift e seleziona la casella di controllo relativa all'ultimo elemento dell'elenco. Verranno selezionati entrambi gli elementi, sia quelli intermedi. Puoi anche fare clic con il tasto Shift su un elemento per selezionare l'elemento e tutti gli elementi al di sopra nell'elenco di directory.

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

   

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

5. Conferma la destinazione selezionata selezionando Sposta, crea una nuova cartella all'interno della cartella selezionata selezionando Nuova cartella oppure 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 tutte le istruzioni include del progetto in modo che corrispondano al nuovo percorso del file. Per informazioni sull'uso di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE della pagina della documentazione relativa al parametro include.

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