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

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

Quando crei file e cartelle, è consigliabile ricordare 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 tua convenzione prevede l'utilizzo di tutte lettere minuscole nel progetto, ti consigliamo di assegnare alla tua cartella il nome views anziché Views. Questo fa la differenza soprattutto quando devi specificare il percorso di un file, ad esempio quando includi i file. In genere, è consigliabile utilizzare lettere minuscole per assegnare un nome a oggetti e cartelle LookML.
• Spazi e caratteri speciali:i nomi file non possono contenere spazi o i seguenti caratteri: / ? * : | " < > %
• Estensioni di file:quando crei file LookML con l'IDE di Looker, Looker aggiunge automaticamente l'estensione .lkml alla fine del nome file, se non includi l'estensione manualmente. Ad esempio, se inserisci il nome del 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, valuta la possibilità 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 per altri sistemi. In generale, dovresti prendere precauzioni per apportare modifiche al modello il più invasive possibile. Per 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 i file delle viste o i file del modello. Puoi anche creare sottocartelle, che è molto utile se vuoi include un sottoinsieme delle tue visualizzazioni.

Nota: quando crei le cartelle, tieni presente che LookML è sensibile alle maiuscole. Assicurati di rispettare le convenzioni del progetto quando assegni un nome alle cartelle. Questo è importante, soprattutto quando devi specificare il percorso di un file, ad esempio quando includi i file. In genere, è consigliabile utilizzare lettere minuscole per assegnare un nome a oggetti e cartelle LookML. Per le limitazioni e i criteri di denominazione dei file e delle cartelle, consulta le note importanti per la creazione di file e cartelle.

Per creare una cartella:

1. Seleziona l'opzione Crea cartella dal menu appropriato:
   • Per creare una nuova cartella al livello più alto della struttura della directory, utilizza il menu Aggiungi file o cartella, a cui puoi accedere selezionando l'icona + (segno 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

Puoi generare automaticamente un file modello e visualizzare i file in base al tuo database quando crei un nuovo progetto. Per i progetti esistenti, puoi creare nuovi file manualmente.

Nota: ti consigliamo di utilizzare l'IDE di Looker per aggiungere file al progetto LookML, creandoli nell'IDE di Looker come descritto di seguito in questa sezione o caricandoli nell'IDE di Looker. Se invece crei file al di fuori dell'IDE Looker e poi utilizzi l'IDE Looker per eseguire il pull dal (ramo di produzione), assicurati di utilizzare le convenzioni di denominazione corrette e includi l'estensione .lkml nel nome file (o explore.lkml per i file Explore). Se il nome file include caratteri non supportati, nel browser del file IDE di Looker il nome file sarà di colore rosso e non potrai visualizzarne i contenuti finché non rinomini il file con caratteri supportati. Inoltre, l'IDE di Looker non mostrerà affatto il file se il file 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 + (segno 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 che vuoi creare. Seleziona i link nel seguente elenco per una descrizione più dettagliata di ogni tipo di file. Puoi creare i seguenti tipi di file:

   • File del modello con estensione .model.lkml
   • Visualizza i file con l'estensione del file .view.lkml*
   • File manifest di progetti denominati sempre manifest.lkml**
   • File della dashboard con l'estensione del file .dashboard.lookml
   • File di documenti con estensione .md
   • File di stringa locali con l'estensione del file .strings.json***
   • File LookML generici, utilizzati per i seguenti tipi di file:
     • Esplora i file con l'estensione del file .explore.lkml****
     • File di test dei dati con estensione .lkml
     • Perfezionamenti dei file con l'estensione del file .lkml
     • Qualsiasi altro file che stai utilizzando per ospitare gli elementi LookML
   Nota:

   ^* Consulta la sezione Considerazioni per la creazione di file delle viste in questa pagina per istruzioni sui metodi alternativi per la creazione di file delle viste, incluse le istruzioni per aggiungere file di vista 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 di Looker e solo se il progetto non ha ancora un file manifest. Questo perché un progetto può avere un solo file manifest, che deve trovarsi a livello della directory principale della struttura di progetto.

   ^*** L'opzione Crea file di impostazioni internazionali è disponibile solo dall'icona Aggiungi file o cartella + (più) nella parte superiore del browser di file nell'IDE di Looker. Tuttavia, una volta che un file di impostazioni internazionali è stato creato (o caricato), puoi spostarlo in una cartella. Se devi creare file di impostazioni internazionali per localizzare il modello e vuoi anche usare la localizzazione nativa dell'interfaccia utente di Looker, devi assegnare un nome ai file stringa utilizzando codici di impostazioni internazionali specifici disponibili 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. Se stai caricando il file, devi utilizzare l'estensione completa di .explore.lkml. Se utilizzi l'IDE Looker per creare il file con l'opzione File LookML generici, Looker aggiunge .lkml alla fine del nome file, se l'estensione non è presente, ma devi comunque aggiungere manualmente la parte .explore dell'estensione al nome file. Ad esempio, per creare un file Explore denominato flights utilizzando l'IDE di Looker, puoi inserire flights.explore o flights.explore.lkml; il nome del file sarà flights.explore.lkml.

3. Nel popup Crea file, inserisci un nome per il nuovo file. Per le limitazioni e i criteri di denominazione dei file, consulta le note importanti per la creazione di file e cartelle.

4. Seleziona Crea. Il nuovo file verrà visualizzato nel punto in cui è 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 agli elementi del file in altri file LookML del tuo progetto. Per ulteriori informazioni, consulta la pagina della documentazione relativa al parametro include.

Nota: se l'amministratore di Looker ha abilitato la funzionalità Migliora LookML Generation di Labs, nella parte superiore del riquadro Browser file troverai il menu Aggiungi file o cartella + (oltre a quelle elencate qui).

Considerazioni per la creazione di file delle viste

La maggior parte degli sviluppatori LookML inizia con uno o più file View 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 la creazione di file di vista vuoti e per il caricamento di file, esistono molti modi in cui uno sviluppatore di Looker in modalità di sviluppo può aggiungere file di vista a un progetto LookML:

• Creazione dei file di visualizzazione in base a tabelle in un database:

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

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

  • Iniziare con un file vista vuoto utilizzando una delle opzioni descritte in questa pagina e poi definire manualmente la tabella derivata, come descritto nella sezione Definire una tabella derivata nativa in LookML nella pagina della documentazione Creazione di tabelle derivate native
  • Fare in modo che Looker crei la tabella LookML derivata da una tabella Explore, come descritto nella sezione Utilizzo di un'esplorazione per iniziare a definire le tabelle native derivate della pagina della documentazione Creazione di tabelle derivate native.
  • Chiedere a Looker di creare la tabella LookML derivata da una query SQL Runner, come descritto nella pagina della documentazione Utilizzo di SQL Runner per la creazione di tabelle derivate

Per utilizzare una nuova vista, aggiungilo al file del modello utilizzando il parametro explore o il parametro join per unirlo a un'esplorazione esistente nel file del modello.

Aggiunta di una nuova vista da una tabella di database esistente

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

1. All'interno di un progetto, seleziona il menu Add file or folder (Aggiungi file o cartella) selezionando il segno + (più) in cima all'elenco dei file di progetto nell'IDE di Looker oppure seleziona il menu di una cartella per creare il file all'interno della cartella.

2. Seleziona Crea vista dalla tabella.

3. Looker visualizza un elenco delle 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 viste 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 viste contenenti LookML per tutte le colonne della tabella.

Caricamento di file

Puoi anche caricare file sul tuo progetto dal computer. Questo è 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 le limitazioni e le linee guida per la denominazione dei file.

Per caricare un file nel progetto, utilizza la funzione di trascinamento nell'IDE 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 di directory.
3. Una volta caricato il file, spostalo 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 progetto. Per ulteriori informazioni, consulta la pagina della documentazione relativa al parametro include.

Eliminare file e cartelle

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

Nota: se elimini una cartella, ne elimini anche il contenuto, quindi fai attenzione quando la elimini. Prima di eliminare una cartella, procedi come segue:

• Verifica di voler eliminare i file nella cartella o spostali in un'altra posizione prima di eliminarli.
• Verifica che la cartella non contenga file a cui si fa riferimento nelle istruzioni include del tuo progetto. Per informazioni sull'utilizzo di include con le cartelle IDE, consulta la sezione Utilizzo di include con le cartelle IDE nella 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, che include la cartella e gli eventuali file al suo interno.

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

Eliminazione di file e cartelle in blocco

Per eliminare cartelle e file in blocco:

Nota: se elimini una cartella, ne eliminerai tutti i contenuti. Prima di eliminare una cartella, verifica di voler eliminare i file al suo interno. Se vuoi conservarli, sposta i file in una posizione diversa prima di eliminare la cartella.

1. Seleziona l'icona 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 i singoli file, espandi le rispettive 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 di directory, utilizza il tasto Shift. Seleziona la casella di controllo relativa all'elemento principale dell'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo relativa all'ultimo elemento dell'elenco. Verranno selezionati sia gli elementi che tutti gli elementi intermedi. Puoi anche fare Shift e fare clic su un elemento per selezionare l'elemento e i relativi elementi nell'elenco delle directory.

3. Seleziona l'icona del cestino Elimina elementi. L'IDE mostrerà quindi un menu popup in cui sono elencati gli elementi selezionati.

   

4. Conferma gli elementi da eliminare selezionando Sì, Elimina o 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 una cartella

Puoi trascinare un singolo file o un'intera cartella con tutti i suoi contenuti in nuove posizioni:

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 le 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 nella pagina della documentazione del parametro include.

Inoltre, tieni presente che quando modifichi il percorso di un file, Git lo elimina definitivamente e crea un nuovo file con il nuovo percorso. Ciò significa che la cronologia Git del file sarà vuota, perché Git lo considera un nuovo file. Per vedere la cronologia Git del file prima dello spostamento, utilizza l'interfaccia Git per andare al file nella sua posizione originale e visualizza la cronologia Git da lì. La stessa logica si applica a un file rinominato, in quanto Git lo elimina definitivamente e crea un nuovo file con un nome diverso.

Spostamento collettivo di file e cartelle

Per spostare cartelle e file in blocco:

1. Seleziona l'icona 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 i singoli file, espandi le rispettive 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 di directory, utilizza il tasto Shift. Seleziona la casella di controllo relativa all'elemento principale dell'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo relativa all'ultimo elemento dell'elenco. Verranno selezionati sia gli elementi che tutti gli elementi intermedi. Puoi anche fare Shift e fare clic su un elemento per selezionare l'elemento e i relativi elementi nell'elenco delle directory.

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

   

4. Nel menu popup Sposta in, scegli una cartella per gli elementi selezionati oppure 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 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 del 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 le 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 nella pagina della documentazione del parametro include.

Inoltre, tieni presente che quando modifichi il percorso di un file, Git lo elimina definitivamente e crea un nuovo file con il nuovo percorso. Ciò significa che la cronologia Git del file sarà vuota, perché Git lo considera un nuovo file. Per vedere la cronologia Git del file prima dello spostamento, utilizza l'interfaccia Git per andare al file nella sua posizione originale e visualizza la cronologia Git da lì. La stessa logica si applica a un file rinominato, in quanto Git lo elimina definitivamente e crea un nuovo file con un nome diverso.