Lo strumento di convalida delle asserzioni di integrazione continua esegue i test sui dati LookML creati dagli sviluppatori Looker nel tuo progetto LookML e mostra i risultati di ogni test sui dati. Per i test dei dati non riusciti, lo strumento di convalida delle asserzioni mostra l'errore.
I test sui dati LookML ti consentono di convalidare la logica del tuo modello Looker. I test sui dati possono verificare ipotesi complesse, ad esempio:
- Le entrate di maggio dell'anno scorso dovrebbero 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 è costituito da una piccola query explore_source e da un'espressione di asserzione yesno, come nel seguente esempio:
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 suite CI, consulta la sezione Opzioni di Assert Validator di questa pagina. Per informazioni sull'esecuzione di Assert Validator, consulta la pagina di documentazione Esecuzione di suite di integrazione continua.
Nella pagina dei risultati dell'esecuzione, lo strumento di convalida delle asserzioni mostra i risultati di ogni test dei dati. Per i test dei dati non riusciti, lo strumento di convalida delle asserzioni mostra l'errore o gli errori nel seguente modo:
Opzioni dello strumento di convalida Assert
Quando crei o modifichi una suite di integrazione continua, puoi specificare diverse opzioni per configurare l'esecuzione di Assert Validator. Le opzioni sono descritte nelle sezioni seguenti di questa pagina:
Esplorazioni da sottoporre a query
Per impostazione predefinita, lo strumento di convalida delle asserzioni esegue ogni test dei dati nel progetto LookML.
I test sui dati vengono definiti utilizzando un parametro explore_source che punta a un'esplorazione nel tuo progetto. Puoi utilizzare il campo Esplorazioni da interrogare per limitare la convalida delle asserzioni a esplorazioni specifiche su cui si basano i test sui 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 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 delle asserzioni esegue ogni test dei dati nel 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. Assert Validator 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 le esplorazioni e i modelli in questo campo, consulta la pagina della documentazione SQL Validator.
Concorrenza delle query
Per impostazione predefinita, lo strumento di convalida delle asserzioni esegue non più di 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 Query concurrency (Contemporaneità delle query) è limitato all'impostazione Max concurrent queries for this connection (Numero massimo di query contemporanee per questa connessione) nella connessione al database.
Se noti un rallentamento dell'istanza di Looker durante l'esecuzione della convalida delle asserzioni, puoi diminuire questo valore.