Convalida di LookML

Quando modifichi il tuo LookML, l'IDE di Looker ti avviserà di eventuali errori di sintassi non risolti all'interno di un singolo file (consulta la pagina della documentazione Panoramica dell'IDE Looker).

Per eseguire una convalida completa del modello, utilizza lo strumento di convalida LookML. Alcuni errori, come un riferimento a un campo non valido dovuto a un join mancante, richiedono un'analisi olistica del modello e pertanto vengono mostrati solo quando viene eseguito lo strumento di convalida LookML. Assicurati di convalidare le modifiche a LookML prima di pubblicarle nell'ambiente di produzione. Sebbene la convalida non rilevi tutti i problemi, ad esempio quelli di autorizzazione del database, impedirà la maggior parte degli errori.

Lo strumento di convalida di LookML analizza solo i file di LookML che sono stati aggiornati dall'ultima convalida di LookML o i file interessati dagli aggiornamenti:

  • Se un'impostazione a livello di modello viene modificata, tutto viene convalidato di nuovo.
  • Se una visualizzazione cambia, vengono convalidate di nuovo solo le esplorazioni in cui viene utilizzata.
  • Se un'esplorazione cambia, viene convalidata solo quella.

Convalida in corso

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 da risolvere. Puoi selezionare qualsiasi freccia per espandere gli elenchi di errori o avvisi.

Il pulsante di convalida nel riquadro Stato del progetto diventerà di nuovo disponibile se apporti e salvi un'altra modifica.

Messaggi di convalida

Looker visualizza i messaggi di convalida dopo l'esecuzione della convalida in LookML.

Nessun errore LookML trovato

Quando non vengono rilevati problemi dallo strumento di convalida, Looker visualizza un segno di spunta verde insieme al testo Nessun errore LookML trovato.

Errori 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):

Esempio di messaggio di convalida con il testo Errori LookML (9).

Nell'elenco espanso dei problemi, vedrai il motivo per cui la convalida non è andata a buon fine. Spesso, se fai clic sull'errore, viene visualizzata direttamente la riga di codice problematica. Viene visualizzata una "X" rossa accanto alla riga. In alcuni casi, se passi il mouse sopra l'errore, vengono visualizzate informazioni più dettagliate:

Esempio di un errore visualizzato al passaggio del mouse per una definizione del parametro type senza valore, con il testo dell'errore che indica che devi fornire un valore per il tipo.

Suggerimento del team di chat: l'errore di convalida più comune è "Campo sconosciuto o inaccessibile". Visita la pagina delle best practice per Errore: campo sconosciuto o inaccessibile per conoscere le cause e sapere come intervenire.

Avvisi LookML

Gli avvisi di LookML potrebbero non impedire l'esecuzione di una query, ma potrebbero comunque comportare una funzionalità interrotta o indesiderata per gli utenti. Come per gli errori, il numero tra parentesi indica il numero di avvisi trovati (tre avvisi nell'esempio seguente):

Esempio di messaggio di convalida con il testo Avvisi LookML (3).

Come per gli errori di LookML, puoi espandere gli avvisi e passare al codice del problema selezionando l'avviso nel riquadro Integrità del progetto e passando il mouse sopra l'icona X rossa per visualizzare ulteriori informazioni:

Esempio di un avviso con un testo che indica che l'esplorazione deve corrispondere a un nome di vista o che deve avere una proprietà from o view_name.

Eseguire il deployment delle modifiche

Dopo aver verificato il corretto funzionamento delle modifiche, puoi utilizzare l'integrazione Git di Looker per eseguire il commit delle modifiche ed eseguirne il deployment in produzione.