Lo Strumento di convalida Assert per l'integrazione continua (CI) esegue i test dei dati LookML creati dagli sviluppatori Looker nel tuo progetto LookML e mostra i risultati di ogni test dei dati. Per i test dei dati non riusciti, lo Strumento di convalida Assert mostra l'errore.
I test dei dati LookML ti consentono di convalidare la logica del tuo modello Looker. I test dei dati possono verificare ipotesi complesse, ad esempio le seguenti:
- Le entrate di maggio dell'anno scorso devono essere pari a 204.259 $.
- Il tasso di conversione deve essere maggiore di zero.
- Lo stato dell'ordine non deve essere nullo.
Un test dei dati LookML è composto da una piccola query explore_source e da un'espressione di asserzione yesno, come nell'esempio seguente:
test: historic_revenue_is_accurate {
explore_source: orders {
column: total_revenue { field: orders.total_revenue }
filters: [orders.created_date: "2024"]
}
assert: revenue_is_expected_value {
expression: ${orders.total_revenue} = 626000 ;;
}
}
Per informazioni dettagliate sulle opzioni che puoi configurare quando crei o modifichi una CI continua, consulta la sezione Opzioni dello Strumento di convalida Assert in questa pagina. Per informazioni sull'esecuzione dello Strumento di convalida Assert, consulta la pagina della documentazione Esecuzione di suite di integrazione continua.
Nella pagina dei risultati dell'esecuzione, lo Strumento di convalida Assert mostra i risultati di ogni test dei dati. Per i test dei dati non riusciti, lo Strumento di convalida Assert mostra l'errore o gli errori, come segue:
Opzioni dello Strumento di convalida Assert
Quando crei o modifichi una suite di integrazione continua, puoi specificare diverse opzioni per configurare la modalità di esecuzione dello Strumento di convalida Assert. Le opzioni sono descritte nelle seguenti sezioni di questa pagina:
Esplorazioni da sottoporre a query
Per impostazione predefinita, lo Strumento di convalida Assert esegue ogni test dei dati nel tuo progetto LookML.
I test dei dati vengono definiti utilizzando un parametro explore_source che rimanda a un'esplorazione nel tuo progetto. Puoi utilizzare il campo Esplorazioni da sottoporre a query per limitare la convalida delle asserzioni a esplorazioni specifiche su cui si basano i test dei dati.
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: thelook/users, thelook/orders
Per ulteriori informazioni ed esempi su come specificare esplorazioni e modelli in questo campo, consulta la pagina della documentazione Strumento di convalida SQL.
Esplorazioni da escludere
Per impostazione predefinita, lo Strumento di convalida Assert esegue ogni test dei dati nel tuo progetto LookML. Puoi utilizzare il campo Esplorazioni da escludere per escludere dalla convalida delle asserzioni esplorazioni specifiche su cui si basano i test dei dati. Lo Strumento di convalida Assert non eseguirà i test dei dati basati su queste esplorazioni escluse.
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 Strumento di convalida SQL.
Concorrenza delle query
Per impostazione predefinita, lo Strumento di convalida Assert esegue al massimo 10 query alla volta per evitare di sovraccaricare l'istanza Looker. Puoi utilizzare il campo Concorrenza delle query per specificare un numero massimo diverso di query che lo Strumento di convalida Assert può eseguire contemporaneamente.
Il valore massimo per il campo Concorrenza delle query è limitato all'impostazione Numero massimo di query contemporanee per questa connessione nella connessione al database.
Se noti un rallentamento dell'istanza Looker durante l'esecuzione della convalida delle asserzioni, puoi diminuire questo valore.