Validateur d'assertion d'intégration continue

Le validateur d'assertions d'intégration continue (CI) exécute les tests de données LookML créés par les développeurs Looker dans votre projet LookML et affiche les résultats de chaque test de données. Pour les tests de données qui échouent, le validateur Assert affiche l'erreur.

Les tests de données LookML vous permettent de valider la logique de votre modèle Looker. Les tests de données peuvent tester des hypothèses complexes, telles que les suivantes :

  • Les revenus de mai de l'année dernière devraient s'élever à 204 259 $.
  • Le taux de conversion doit être supérieur à zéro.
  • L'état de la commande ne doit pas être nul.

Un test de données LookML est composé d'une petite requête explore_source et d'une expression assert yesno, comme dans l'exemple suivant :

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 ;;
  }
}

Pour en savoir plus sur les options que vous pouvez configurer lorsque vous créez ou modifiez une suite CI, consultez la section Options du validateur Assert de cette page. Pour savoir comment exécuter le validateur d'assertions, consultez la page de documentation Exécuter des suites d'intégration continue.

Sur la page des résultats de l'exécution, le validateur d'assertions affiche les résultats de chaque test de données. Pour les tests de données qui échouent, le validateur Assert affiche la ou les erreurs, comme suit :

Page de résultats de l'intégration continue affichant les résultats du validateur d'assertion

Options du programme de validation Assert

Vous pouvez spécifier plusieurs options lorsque vous créez ou modifiez une suite d'intégration continue pour configurer la façon dont Assert Validator s'exécute. Les options sont décrites dans les sections suivantes de cette page :

Explorations à interroger

Par défaut, le validateur Assert exécute chaque test de données dans votre projet LookML.

Les tests de données sont définis à l'aide d'un paramètre explore_source qui pointe vers une exploration dans votre projet. Vous pouvez utiliser le champ Explorations à interroger pour limiter la validation des assertions à des explorations spécifiques sur lesquelles vos tests de données sont basés.

Vous pouvez spécifier des Explorations au format suivant : model_name/explore_name

Par exemple, pour spécifier les explorations nommées users et orders dans le fichier thelook.model.lkml, vous devez saisir thelook/users, thelook/orders.

Pour en savoir plus et obtenir des exemples sur la façon de spécifier des explorations et des modèles dans ce champ, consultez la page de documentation sur le validateur SQL.

Explorations à exclure

Par défaut, le validateur Assert exécute chaque test de données dans votre projet LookML. Vous pouvez utiliser le champ Explores à exclure pour exclure de la validation des assertions des Explorations spécifiques sur lesquelles vos tests de données sont basés. Le validateur Assert n'exécutera pas les tests de données basés sur ces explorations exclues.

Vous pouvez spécifier des Explorations au format suivant : model_name/explore_name

Pour en savoir plus et obtenir des exemples sur la façon de spécifier des explorations et des modèles dans ce champ, consultez la page de documentation sur le validateur SQL.

Simultanéité des requêtes

Par défaut, le validateur Assert exécute au maximum 10 requêtes à la fois pour éviter de surcharger votre instance Looker. Vous pouvez utiliser le champ Simultanéité des requêtes pour spécifier un nombre maximal différent de requêtes que le programme de validation d'assertion peut exécuter simultanément.

La valeur maximale du champ Simultanéité des requêtes est limitée au paramètre Nombre maximal de requêtes simultanées pour cette connexion de votre connexion à la base de données.

Si vous constatez un ralentissement de votre instance Looker lors de l'exécution de la validation Assert, vous pouvez diminuer cette valeur.