Lo strumento di convalida dei contenuti di integrazione continua (CI) identifica dashboard e Look che presentano errori. Spesso questi errori sono causati da riferimenti mancanti ai campi LookML.
Lo strumento di convalida dei contenuti di CI esegue una convalida simile a quella dello strumento di convalida dei contenuti di Looker standard, con alcune differenze:
Lo strumento di convalida dei contenuti di CI supporta quanto segue:
- Puoi configurare lo strumento di convalida dei contenuti di CI in modo che venga eseguito automaticamente quando uno sviluppatore Looker invia una richiesta di pull al repository LookML o manualmente quando esegui manualmente una suite di CI.
- Puoi limitare i risultati dello strumento di convalida dei contenuti di 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 di CI vengono automaticamente limitati al tuo progetto LookML. La limitazione dello strumento di convalida dei contenuti di CI è una post-elaborazione: lo strumento di convalida viene eseguito sull'intera istanza di Looker e poi filtra i risultati in base all'ambito specificato quando hai creato la suite di CI.
Lo strumento di convalida dei contenuti di Looker standard supporta quanto segue:
- Puoi eseguire lo strumento di convalida dei contenuti di Looker manualmente solo.
- Puoi limitare lo strumento di convalida dei contenuti di Looker a cartelle di contenuti Looker specifiche o a progetti LookML specifici. La limitazione dello strumento di convalida dei contenuti di Looker avviene prima della convalida: lo strumento di convalida viene eseguito solo sulle cartelle e sui progetti specificati quando hai avviato la convalida dei contenuti.
- Puoi utilizzare lo strumento di convalida dei contenuti di Looker per sostituire i nomi di campi, viste, esplorazioni e modelli, per rimuovere i campi e per eliminare i Look.
Per informazioni dettagliate sulle opzioni che puoi configurare quando puoi crei o modifichi una suite di 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 di 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 la modalità di esecuzione dello strumento di convalida dei contenuti. Le opzioni sono descritte nelle seguenti sezioni 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 del tuo progetto LookML.
Puoi utilizzare il campo Esplorazioni da sottoporre a query 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 esplorazioni e modelli in questo campo, consulta la pagina di documentazione Strumento di convalida SQL.
Esplorazioni da escludere
Per impostazione predefinita, lo strumento di convalida dei contenuti esegue la convalida dei contenuti su tutti i modelli e le esplorazioni del tuo 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 esplorazioni e modelli in questo campo, consulta la pagina di documentazione Strumento di convalida SQL.
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 di ID cartella separati da virgole.
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, nell'URL seguente, 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 è attivo, lo strumento di convalida dei contenuti ignora i contenuti delle cartelle personali nella tua 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 dagli errori esistenti nel progetto e può anche velocizzare la convalida, soprattutto per i progetti LookML che contengono molte esplorazioni.
Nei risultati della convalida, lo strumento di convalida dei contenuti indica ogni esplorazione che è stata ignorata perché non sono state apportate modifiche al relativo SQL compilato nel branch o nel commit convalidato. Per un esempio dei risultati della convalida incrementale, consulta Visualizzazione dei 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 dei risultati completi.
Limitazioni della convalida dei contenuti
Se elimini un modello o ne modifichi il nome, lo strumento di convalida dei contenuti non restituisce questi errori di contenuti "non collegati", perché il modello non può più essere associato al progetto in fase di test.