Convalida di LookML

Quando modifichi il codice LookML, l'IDE di Looker ti avvisa di eventuali errori di sintassi irrisolti 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, come un riferimento a un campo non valido a causa di una unione mancante, richiedono un esame olistico del modello e vengono visualizzati 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 ogni problema, ad esempio i problemi di autorizzazione del database, impedisce la maggior parte degli errori.

Il validatore 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 cambia, 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 esecuzione

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 una freccia qualsiasi 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 mostra i messaggi di convalida dopo aver eseguito la convalida del codice LookML.

Nessun errore di LookML trovato

Se lo strumento di convalida non rileva problemi, viene visualizzato un segno di spunta verde con il 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 rilevati (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 con il problema. Accanto alla riga vedrai una "X" rossa. 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 type.

Suggerimento del team di chat: l'errore di convalida più comune è "Campo sconosciuto o inaccessibile". Visita la pagina Best practice Errore: campo sconosciuto o inaccessibile per conoscere le cause e cosa fare.

Avvisi di LookML

Gli avvisi di LookML potrebbero non impedire l'esecuzione di una query, ma potrebbero comunque comportare una funzionalità non intenzionale o non funzionante 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 avviso con il testo che indica che l'esplorazione deve corrispondere a un nome di visualizzazione o che deve avere una proprietà from o view_name.

Eseguire il deployment delle modifiche

Dopo aver verificato che le modifiche funzioneranno correttamente, puoi utilizzare l'integrazione di Git di Looker per eseguire il commit e il deployment delle modifiche in produzione.