Lo strumento di convalida dei contenuti di integrazione continua (CI) identifica le dashboard e i Look che presentano errori. Spesso questi errori sono causati da riferimenti mancanti ai campi LookML.
Lo strumento di convalida dei contenuti CI esegue una convalida simile a quella dello strumento di convalida dei contenuti standard di Looker, con alcune differenze:
Lo strumento di convalida dei contenuti CI supporta quanto segue:
- Puoi configurare lo strumento di convalida dei contenuti CI in modo che venga eseguito automaticamente quando uno sviluppatore Looker invia una richiesta di pull al tuo repository LookML oppure manualmente quando esegui manualmente una suite CI.
- Puoi limitare i risultati dello strumento di convalida dei contenuti CI a cartelle di contenuti Looker specifiche o a modelli ed esplorazioni specifici nel tuo progetto LookML. Per impostazione predefinita, i risultati dello strumento di convalida dei contenuti CI vengono automaticamente limitati al tuo progetto LookML. L'ambito dello strumento di convalida dei contenuti CI è la post-elaborazione: lo strumento di convalida viene eseguito sull'intera istanza di Looker e poi filtra i risultati in base all'ambito specificato durante la creazione della suite CI.
Lo strumento di convalida dei contenuti standard di Looker supporta quanto segue:
- Puoi eseguire lo strumento di convalida dei contenuti di Looker solo manualmente.
- Puoi limitare l'ambito dello strumento di convalida dei contenuti di Looker a cartelle di contenuti di Looker specifiche o a progetti LookML specifici. L'ambito dello strumento di convalida dei contenuti di Looker viene definito prima della convalida: lo strumento viene eseguito solo sulle cartelle e sui progetti specificati quando è stata avviata la convalida dei contenuti.
- Puoi utilizzare lo strumento di convalida dei contenuti di Looker per sostituire i nomi di campi, visualizzazioni, esplorazioni e modelli, per rimuovere i campi e per eliminare i Look.
Per informazioni dettagliate sulle opzioni che puoi configurare quando crei o modifichi una suite CI, consulta la sezione Opzioni dello strumento di convalida dei contenuti di questa pagina. Per informazioni sull'esecuzione dello strumento di convalida dei contenuti, consulta la pagina della documentazione Esecuzione di suite di integrazione continua.
Nella pagina dei risultati dell'esecuzione, lo strumento di convalida dei contenuti fornisce il messaggio di errore per ogni Look o dashboard con errori, insieme a un link ai contenuti:
Opzioni dello strumento di convalida dei contenuti
Quando crei una suite di integrazione continua, puoi specificare diverse opzioni per configurare l'esecuzione dello strumento di convalida dei contenuti. Le opzioni sono descritte nelle sezioni seguenti di questa pagina:
- Esplorazioni da sottoporre a query
- Esplorazioni da escludere
- Cartelle da convalidare
- Cartelle da escludere
- Escludi contenuti nelle cartelle personali
- Convalida incrementale
Esplorazioni da sottoporre a query
Per impostazione predefinita, lo strumento di convalida dei contenuti esegue la convalida dei contenuti su tutti i modelli e le esplorazioni nel progetto LookML.
Puoi utilizzare il campo Esplorazioni da interrogare per specificare l'esplorazione e i modelli da includere nella convalida dei contenuti.
Puoi specificare le esplorazioni nel seguente formato: model_name/explore_name
Ad esempio, per specificare le esplorazioni denominate users e orders nel file thelook.model.lkml, devi inserire quanto segue: thelook/users, thelook/orders
Per ulteriori informazioni ed esempi su come specificare le esplorazioni e i modelli in questo campo, consulta la pagina della documentazione SQL Validator.
Esplorazioni da escludere
Per impostazione predefinita, lo strumento di convalida dei contenuti esegue la convalida dei contenuti su tutti i modelli e le esplorazioni nel progetto LookML.
Puoi utilizzare il campo Esplorazioni da escludere per specificare l'esplorazione e i modelli da escludere dalla convalida dei contenuti.
Puoi specificare le esplorazioni nel seguente formato: model_name/explore_name
Per ulteriori informazioni ed esempi su come specificare le esplorazioni e i modelli in questo campo, consulta la pagina della documentazione SQL Validator.
Cartelle da convalidare
Puoi limitare la convalida dei contenuti a cartelle di contenuti specifiche nella tua istanza di Looker specificando un ID cartella o un elenco separato da virgole di ID cartella.
Per ottenere l'ID di una cartella, utilizza il menu di navigazione principale di Looker per aprire la cartella, quindi recupera l'ID cartella dall'URL del browser. L'ID cartella è l'ultimo elemento dell'URL. Ad esempio, nel seguente URL, l'ID cartella è 45:
https://myinstance.looker.com/folders/45
Cartelle da escludere
Puoi escludere cartelle di contenuti specifiche dalla convalida dei contenuti specificando un ID cartella o un elenco separato da virgole di ID cartella nel campo Cartelle da escludere.
Escludi contenuti nelle cartelle personali
Se vuoi che lo strumento di convalida dei contenuti convalidi solo i contenuti delle cartelle condivise, attiva il campo Escludi contenuti nelle cartelle personali. Quando il campo Escludi contenuti nelle cartelle personali è attivato, lo strumento di convalida dei contenuti ignora i contenuti nelle cartelle personali dell'istanza di Looker.
Convalida incrementale
La convalida incrementale è un metodo per individuare errori unici per un branch di sviluppo specifico, errori che non esistono già in produzione. La convalida incrementale aiuta gli sviluppatori a trovare e correggere gli errori di cui sono responsabili senza essere distratti da errori esistenti nel progetto e può anche rendere la convalida più veloce, soprattutto per i progetti LookML che contengono molte esplorazioni.
Nei risultati dello strumento di convalida, lo strumento di convalida dei contenuti indica ogni esplorazione ignorata perché non sono state apportate modifiche al relativo SQL compilato nel branch o nel commit in fase di convalida. Consulta Visualizzazione dei risultati della convalida incrementale per un esempio di risultati della convalida incrementale.
Puoi attivare la convalida incrementale per lo strumento di convalida dei contenuti selezionando la casella di controllo Solo errori incrementali nella sezione Strumento di convalida dei contenuti quando crei o modifichi una suite di integrazione continua.
Tieni presente quanto segue per la convalida incrementale:
- L'impostazione di convalida incrementale non si applica quando lo strumento di convalida dei contenuti convalida il branch di produzione stesso, ad esempio con esecuzioni manuali nel branch di produzione. Quando convalida il branch di produzione, lo strumento di convalida dei contenuti mostra la convalida completa dei risultati.
Limitazioni della convalida dei contenuti
Se elimini un modello o ne modifichi il nome, lo strumento di convalida dei contenuti non restituisce questi errori relativi ai contenuti "pendenti", perché il modello non può più essere associato al progetto in fase di test.