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 della documentazione Panoramica dell'IDE di Looker).
Per eseguire una convalida completa del modello, utilizza lo strumento di convalida LookML. Alcuni errori, come un riferimento a un campo non valido a causa di un join mancante, richiedono una visione olistica del modello e pertanto vengono visualizzati solo quando viene eseguito lo strumento di convalida LookML. Assicurati di convalidare le modifiche LookML prima di pubblicarle nell'ambiente di produzione. Sebbene la convalida non rilevi ogni problema, ad esempio i problemi di autorizzazione del database, impedisce 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 viene modificata un'impostazione a livello di modello, viene convalidato di nuovo tutto.
- Se una vista viene modificata, vengono convalidate di nuovo solo le esplorazioni in cui viene utilizzata.
- Se un'esplorazione viene modificata, viene convalidata di nuovo solo quell'esplorazione.
Esecuzione della convalida
Per eseguire lo strumento di convalida LookML, seleziona il pulsante Convalida 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 Convalida 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 Stato del progetto sarà di nuovo 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 di 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, ti viene visualizzata direttamente la riga di codice del problema. Vedrai una "X" rossa accanto alla riga. In alcuni casi, se passi il mouse sopra, vengono visualizzate informazioni più dettagliate sull'errore:
Suggerimento del team di chat: l'errore di convalida di cui ci viene chiesto più spesso è "Campo sconosciuto o inaccessibile". Visita la pagina Best practice per l'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 indesiderate per gli utenti. Come per gli errori, il numero tra parentesi indica il numero di avvisi trovati (tre avvisi nell'esempio seguente):
Come per gli errori di LookML, puoi espandere gli avvisi e passare al codice del problema selezionando l'avviso nel riquadro Stato del progetto e poi passando il mouse sopra l'icona X rossa per visualizzare ulteriori informazioni:
Eseguire il 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 in produzione.