Lo strumento Content Validator per l'integrazione continua (CI) identifica le dashboard e i look con errori. Spesso questi errori sono causati da riferimenti mancanti ai campi LookML.
Lo strumento di convalida dei contenuti di Content ID esegue una convalida simile a quella dello strumento di convalida dei contenuti di Looker standard, con alcune differenze:
Lo strumento di convalida dei contenuti CI supporta quanto segue:
- Puoi configurare lo strumento di convalida dei contenuti di CI in modo che venga eseguito automaticamente quando uno sviluppatore di Looker invia una richiesta di pull al tuo repository LookML oppure manualmente quando esegui manualmente una suite di CI.
- Puoi limitare l'ambito dei risultati di Content Validator CI a cartelle di contenuti di Looker specifiche o a modelli ed esplorazioni specifici nel tuo progetto LookML. Per impostazione predefinita, i risultati dello strumento di convalida dei contenuti CI sono automaticamente limitati al progetto LookML. L'ambito dello strumento di convalida dei contenuti della suite CI è la post-elaborazione: lo strumento viene eseguito sull'intera istanza di Looker e poi filtra i risultati in base all'ambito specificato quando hai creato la suite CI.
Lo strumento di convalida dei contenuti di Looker standard supporta quanto segue:
- Puoi eseguire lo strumento di convalida dei contenuti di Looker solo manualmente.
- Puoi limitare l'ambito del validatore 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 hai avviato la convalida dei contenuti.
- Puoi utilizzare lo strumento di convalida dei contenuti di Looker per sostituire i nomi di campi, visualizzazioni, esplorazioni e modelli, rimuovere campi ed eliminare i Look.
Consulta la sezione Opzioni di Content Validator di questa pagina per informazioni dettagliate sulle opzioni che puoi configurare quando crei o modifichi una suite CI. Per informazioni sull'esecuzione di Content Validator, consulta la pagina della documentazione relativa all'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 dashboard o look con errori, oltre a un link ai contenuti:
Opzioni di Content Validator
Quando crei una suite di integrazione continua, puoi specificare diverse opzioni per configurare l'esecuzione di Content Validator. Le opzioni sono descritte nelle seguenti sezioni di questa pagina:
- Esplorazioni da sottoporre a query
- Esplorazioni da escludere
- Cartelle da convalidare
- Cartelle da escludere
- Escludere contenuti nelle cartelle personali
- Convalida incrementale
Esplorazioni da sottoporre a query
Per impostazione predefinita, lo strumento Content Validator esegue la convalida dei contenuti su tutti i modelli e le esplorazioni del progetto LookML.
Puoi utilizzare il campo Esplorazioni su cui eseguire 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 della documentazione di SQL Validator.
Esplorazioni da escludere
Per impostazione predefinita, lo strumento Content Validator esegue la convalida dei contenuti su tutti i modelli e le esplorazioni del 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 della documentazione di 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 di ID cartella separati da virgole.
Per ottenere l'ID di una cartella, utilizza il menu di navigazione principale di Looker per aprirla, quindi recupera l'ID dalla 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 di ID cartella separati da virgole nel campo Cartelle da escludere.
Escludere i contenuti nelle cartelle personali
Se vuoi che Content Validator 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 Content Validator ignora i contenuti delle 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 loro competenza senza essere distratti dagli errori esistenti nel progetto e può anche velocizzare la convalida, in particolare per i progetti LookML che contengono molte esplorazioni.
Nei risultati del validatore, lo strumento di convalida dei contenuti indica ogni esplorazione saltata perché non sono state apportate modifiche al codice SQL compilato nel ramo o nel commit sottoposto a convalida. Consulta la sezione Visualizzazione dei risultati per la 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 cambi il nome, lo strumento Content Validator non restituisce questi errori di contenuti "inutilizzati", perché il modello non può più essere associato al progetto in fase di test.