Quando modifichi il codice LookML, l'IDE di Looker ti avvisa di eventuali errori di sintassi non risolti all'interno di un singolo file (consulta la pagina di documentazione Panoramica dell'IDE di Looker).
Per eseguire una convalida completa del modello, utilizza lo strumento di convalida LookML. Alcuni errori, ad esempio un riferimento di campo non valido a causa di un join mancante, richiedono un'analisi olistica del modello e pertanto vengono visualizzati solo quando viene eseguito il validatore LookML. Assicurati di convalidare le modifiche LookML prima di pubblicarle nell'ambiente di produzione. Sebbene la convalida non rilevi tutti i problemi, ad esempio quelli relativi alle autorizzazioni del database, previene la maggior parte degli errori.
Lo strumento di convalida LookML esegue la scansione solo dei file LookML aggiornati dall'ultima convalida LookML o dei file interessati dagli aggiornamenti:
- Se un'impostazione a livello di modello cambia, viene eseguita di nuovo la convalida di tutto.
- Se una visualizzazione cambia, vengono convalidati nuovamente solo gli Explore in cui viene utilizzata.
- Se una funzionalità Esplora cambia, viene convalidata di nuovo solo quella.
Esecuzione della convalida
Per eseguire il validatore LookML, seleziona il pulsante Valida LookML in alto a destra nell'IDE di Looker oppure seleziona l'icona Stato del progetto nella parte superiore dell'IDE per aprire il riquadro Stato del progetto e poi fai clic sull'icona Valida LookML.
Dopo aver eseguito lo strumento di convalida LookML, potresti visualizzare un elenco di errori e altri avvisi che devi risolvere. Puoi selezionare una freccia per espandere gli elenchi di errori o avvisi.
Il pulsante di convalida nel riquadro Integrità del progetto tornerà disponibile se apporti e salvi un'altra modifica.
Messaggi di convalida
Looker mostra i messaggi di convalida dopo aver eseguito la convalida del codice LookML.
Nessun errore di LookML trovato
Quando lo strumento di convalida non rileva problemi, Looker mostra un segno di spunta verde insieme al testo Nessun errore di LookML trovato.
Errori di LookML
Gli errori LookML sono problemi che potrebbero impedire l'esecuzione delle query. Il numero tra parentesi indica il numero di errori trovati (nove nell'esempio seguente):
Nell'elenco espanso dei problemi, vedrai il motivo per cui la convalida non è stata superata. Spesso, se fai clic sull'errore, viene visualizzata direttamente la riga di codice problematica. Vedrai una "X" rossa accanto alla riga. In alcuni casi, se passi il mouse sopra l'errore, vengono visualizzate informazioni più dettagliate:
Suggerimento del team di chat: l'errore di convalida più frequente è "Campo sconosciuto o inaccessibile". Visita la pagina delle best practice Errore: campo sconosciuto o inaccessibile per scoprire le cause e cosa fare.
Avvisi di LookML
Gli avvisi di LookML potrebbero non impedire l'esecuzione di una query, ma potrebbero comunque causare funzionalità interrotte o non intenzionali per i tuoi utenti. Come per gli errori, il numero tra parentesi indica il numero di avvisi trovati (tre avvisi nell'esempio seguente):
Come per gli errori LookML, puoi espandere gli avvisi e passare al codice problematico selezionando l'avviso nel riquadro Integrità del progetto e poi passando il mouse sopra l'icona X rossa per visualizzare ulteriori informazioni:
Deployment delle modifiche
Dopo aver verificato che le modifiche funzioneranno correttamente, puoi utilizzare l'integrazione Git di Looker per eseguire il commit e il deployment delle modifiche nell'ambiente di produzione.