Validateur d'assertion d'intégration continue

L'outil de validation d'assertion d'intégration continue (CI) exécute les tests de données LookML créés par les développeurs Looker dans votre projet LookML, puis affiche les résultats de chaque test de données. En cas d'échec des tests de données, l'outil de validation 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 "null".

Un test de données LookML se compose d'une petite requête explore_source et d'une expression d'assertion 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 ;;
  }
}

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

Sur la page Résultats de l'exécution, l'outil de validation Assert affiche les résultats de chaque test de données. Pour les tests de données qui échouent, l'outil de validation Assert affiche l'erreur ou les erreurs, comme suit:

Page de résultats de l'intégration continue affichant les résultats de l'outil de validation Assert

Options de validation d'assertion

Lorsque vous créez ou modifiez une suite d'intégration continue, vous pouvez spécifier plusieurs options pour configurer l'exécution d'Assert Validator. Les options sont décrites dans les sections suivantes de cette page:

Explorations à interroger

Par défaut, l'outil de validation Assert exécute chaque test de données de votre projet LookML.

Les tests de données sont définis à l'aide d'un paramètre explore_source qui pointe vers une exploration de votre projet. Vous pouvez utiliser le champ Explorations à interroger pour limiter la validation d'assertion aux 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 ce qui suit: 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 du programme de validation SQL.

Explorations à exclure

Par défaut, l'outil de validation Assert exécute chaque test de données de votre projet LookML. Vous pouvez utiliser le champ Explorations à exclure pour exclure de la validation d'assertion des explorations spécifiques sur lesquelles vos tests de données sont basés. L'outil de validation 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 du programme de validation SQL.

Simultanéité des requêtes

Par défaut, l'outil de validation Assert n'exécute pas plus de 10 requêtes à la fois pour éviter d'encombrer votre instance Looker. Vous pouvez utiliser le champ Concurrency des requêtes pour spécifier un nombre maximal 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 de base de données.

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