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 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 di file e cartelle importanti

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

  • Distinzione tra maiuscole e minuscole:LookML è sensibile alle maiuscole. Assicurati di rispettare le convenzioni del tuo progetto quando assegni un nome alle cartelle. Ad esempio, se la tua convenzione prevede l'utilizzo di tutte lettere minuscole nel progetto, potresti assegnare alla cartella il nome views anziché Views. Questo fa la differenza, soprattutto quando devi specificare il percorso di un file, ad esempio quando inclusi i file. In genere, è consigliabile utilizzare in modo coerente lettere minuscole quando assegni un nome a oggetti e cartelle LookML.
  • Spazi e caratteri speciali: i nomi file non possono includere spazi o 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 includi l'estensione manualmente. Ad esempio, se inserisci il nome del 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, 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, conservando l'URL sottostante utilizzato per email o altri sistemi. In generale, è necessario adottare precauzioni per rendere le 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 visualizza file o file di modello). Puoi anche creare delle sottocartelle, una soluzione molto utile se vuoi include un sottoinsieme delle tue viste.

Per creare una cartella:

  1. Seleziona l'opzione Crea cartella dal menu appropriato:
    • Per creare una nuova cartella al livello più alto 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 una nuova sottocartella all'interno di 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.

Per creare un nuovo file nel tuo progetto LookML:

  1. Seleziona il menu appropriato:

    • Per creare un nuovo file al livello più alto 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.

  2. Seleziona il tipo di file LookML che vuoi creare. Seleziona i link nell'elenco seguente per una descrizione più dettagliata di ciascun tipo di file. Puoi creare i seguenti tipi di file:

  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 dei nomi ai file.

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

Considerazioni sulla creazione dei file di visualizzazioni

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 insieme di tabelle in un database. Tuttavia, oltre ai metodi descritti in questa pagina per creare file di viste vuoti e caricare file, uno sviluppatore di Looker in modalità sviluppo può aggiungere file di vista a un progetto LookML in molti modi:

Per utilizzare una nuova vista, aggiungila al file del modello usando il parametro explore oppure usa 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 vista 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. In alternativa, puoi selezionare il menu di una cartella per creare il file al suo interno.

  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 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 viste.

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

Caricamento di file

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

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

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

Eliminazione di file e cartelle

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

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

Eliminazione di file e cartelle in blocco

Per eliminare cartelle e file collettivamente:

  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 singoli file, espandi le cartelle 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 per l'elemento in cima all'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo per l'ultimo elemento dell'elenco. Verranno selezionati sia gli elementi che tutti quelli compresi. Puoi anche fare clic e tenere premuto il tasto Shift su un elemento per selezionare l'elemento e tutti gli elementi superiori nell'elenco di directory.

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

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

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

Spostamento di elementi in un progetto in cartelle

Per spostare un file, trascinalo 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 passi il mouse sopra.

Spostamento di file e cartelle in blocco

Per spostare cartelle e file collettivamente:

  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 singoli file, espandi le cartelle 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 per l'elemento in cima all'intervallo, quindi tieni premuto il tasto Shift e seleziona la casella di controllo per l'ultimo elemento dell'elenco. Verranno selezionati sia gli elementi che tutti quelli compresi. Puoi anche fare clic e tenere premuto il tasto Shift su un elemento per selezionare l'elemento e tutti gli elementi superiori nell'elenco di directory.

  3. Seleziona l'icona a forma di 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 di 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 oppure torna al menu principale delle opzioni della cartella selezionando il link con il nome del progetto nel percorso del file.

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