Strumento di convalida assert di integrazione continua

Lo strumento di convalida degli assert di integrazione continua (CI) esegue i test sui dati di LookML creati dagli sviluppatori di Looker nel progetto LookML e mostra i risultati di ciascun test. Per i test dei dati non riusciti, lo strumento di convalida Assert mostra l'errore.

I test dei dati di LookML ti consentono di convalidare la logica del tuo modello di Looker. I test dei dati possono verificare ipotesi complesse, ad esempio:

  • Le entrate di maggio dell'anno scorso dovrebbero ammontare a 204.259 $.
  • Il tasso di conversione deve essere maggiore di zero.
  • Lo stato dell'ordine non deve essere nullo.

Un test dei dati di LookML è costituito 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 ;;
  }
}

Consulta la sezione Opzioni di Assert Validator di questa pagina per informazioni dettagliate sulle opzioni che puoi configurare quando crei o modifichi una suite CI. Per informazioni sull'esecuzione di Assert Validator, consulta la pagina di documentazione Eseguire suite di integrazione continua.

Nella pagina dei risultati dell'esecuzione, lo strumento di convalida dell'affermazione mostra i risultati di ogni test di dati. Per i test dei dati non riusciti, lo strumento di convalida delle asserzioni mostra l'errore o gli errori, come segue:

Pagina dei risultati dell'integrazione continua che mostra i risultati di Assert Validator

Opzioni di Assert Validator

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 seguenti sezioni di questa pagina:

Esplorazioni da sottoporre a query

Per impostazione predefinita, lo strumento di convalida dell'assert eseguirà ogni test dei dati nel progetto LookML.

I test dei dati vengono definiti utilizzando un parametro explore_source che rimanda a un'esplorazione nel progetto e puoi utilizzare il campo Esplorazioni su cui eseguire query per limitare la convalida dell'affermazione 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 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 di convalida dell'assert eseguirà ogni test dei dati nel progetto LookML. Puoi utilizzare il campo Esplorazioni da escludere per escludere dalla convalida dell'affermazione esplorazioni specifiche su cui si basano i tuoi test dei dati. Lo strumento di convalida dell'affermazione 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 di SQL Validator.

Concorrenza delle query

Per impostazione predefinita, lo strumento di convalida dell'assert non esegue 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 Contemporaneità delle query è limitato all'impostazione 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 dell'affermazione, puoi diminuire questo valore.