Le validateur de contenu d'intégration continue (CI) identifie les tableaux de bord et les looks comportant des erreurs. Ces erreurs sont souvent dues à des références manquantes aux champs LookML.
Le programme de validation de contenu de la certification CI effectue une validation similaire à celle du programme de validation de contenu Looker standard, avec quelques différences:
L'outil de validation du contenu de la certification CI est compatible avec les éléments suivants:
- Vous pouvez configurer l'outil de validation du contenu de l'intégration continue pour qu'il s'exécute automatiquement lorsqu'un développeur Looker envoie une demande d'extraction à votre dépôt LookML, ou manuellement lorsque vous exécutez manuellement une suite d'intégration continue.
- Vous pouvez limiter les résultats du programme de validation de contenu du CI à des dossiers de contenu Looker spécifiques, ou à des modèles et des explorations spécifiques de votre projet LookML. Par défaut, les résultats de l'outil de validation du contenu de la CI sont automatiquement limités à votre projet LookML. Le champ d'application de la validation de contenu de la suite CI est le post-traitement: le validateur s'exécute sur l'ensemble de l'instance Looker, puis filtre les résultats en fonction du champ d'application que vous avez spécifié lorsque vous avez créé la suite CI.
L'outil de validation de contenu Looker standard est compatible avec les éléments suivants:
- Vous ne pouvez exécuter l'outil de validation du contenu Looker que manuellement.
- Vous pouvez limiter le champ d'application de l'outil de validation du contenu Looker à des dossiers de contenu Looker spécifiques ou à des projets LookML spécifiques. Le champ d'application de la validation du contenu Looker se produit avant la validation: l'outil de validation ne s'exécute que sur les dossiers et les projets que vous avez spécifiés lorsque vous avez lancé la validation du contenu.
- Vous pouvez utiliser l'outil de validation du contenu Looker pour remplacer les noms de champs, de vues, d'explorations et de modèles, supprimer des champs et supprimer des Looks.
Consultez la section Options du validateur de contenu de cette page pour en savoir plus sur les options que vous pouvez configurer lorsque vous créez ou modifiez une suite de CI. Pour en savoir plus sur l'exécution du validateur de contenu, consultez la page de documentation Exécuter des suites d'intégration continue.
Sur la page des résultats de l'exécution, l'outil de validation du contenu fournit le message d'erreur pour chaque look ou tableau de bord présentant une erreur, ainsi qu'un lien vers le contenu:
Options de la validation de contenu
Vous pouvez spécifier plusieurs options lorsque vous créez une suite d'intégration continue pour configurer l'exécution du validateur de contenu. Les options sont décrites dans les sections suivantes de cette page:
- Explorations à interroger
- Explorations à exclure
- Dossiers à valider
- Dossiers à exclure
- Exclure le contenu des dossiers personnels
- Validation incrémentielle
Explorations à interroger
Par défaut, la validation de contenu s'applique à tous les modèles et explorations de votre projet LookML.
Vous pouvez utiliser le champ Explorations à interroger pour spécifier l'exploration et les modèles que vous souhaitez inclure dans la validation du contenu.
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, le validateur de contenu exécute la validation de contenu sur tous les modèles et toutes les explorations de votre projet LookML.
Vous pouvez utiliser le champ Explorations à exclure pour spécifier les explorations et les modèles que vous souhaitez exclure de la validation du contenu.
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.
Dossiers à valider
Vous pouvez limiter la validation du contenu à des dossiers de contenu spécifiques de votre instance Looker en spécifiant un ID de dossier ou une liste d'ID de dossier séparés par une virgule.
Pour obtenir l'ID d'un dossier, utilisez le menu de navigation principal de Looker pour ouvrir le dossier, puis récupérez l'ID du dossier à partir de l'URL du navigateur. L'ID du dossier est le dernier élément de l'URL. Par exemple, dans l'URL suivante, l'ID du dossier est 45:
https://myinstance.looker.com/folders/45
Dossiers à exclure
Vous pouvez exclure des dossiers de contenu spécifiques de la validation de contenu en spécifiant un ID de dossier ou une liste d'ID de dossier séparés par une virgule dans le champ Dossiers à exclure.
Exclure le contenu des dossiers personnels
Si vous souhaitez que le programme de validation de contenu ne valide que le contenu des dossiers partagés, activez le champ Exclure le contenu des dossiers personnels. Lorsque le champ Exclure le contenu des dossiers personnels est activé, le programme de validation de contenu ignore le contenu des dossiers personnels de votre instance Looker.
Validation incrémentielle
La validation incrémentielle est une méthode permettant de détecter les erreurs qui sont propres à une branche de développement spécifique et qui n'existent pas déjà dans celle de production. La validation incrémentielle aide les développeurs à trouver et à corriger les erreurs dont ils sont responsables sans être distraits par les erreurs existantes du projet. Elle peut également accélérer la validation, en particulier pour les projets LookML contenant de nombreuses explorations.
Dans les résultats du vérificateur de contenu, le vérificateur de contenu indique chaque exploration ignorée, car aucune modification n'a été apportée à son code SQL compilé dans la branche ou le commit en cours de validation. Pour voir un exemple de résultats de validation incrémentielle, consultez Afficher les résultats de la validation incrémentielle.
Vous pouvez activer la validation incrémentielle pour le validateur de contenu en cochant la case Only incremental errors (Uniquement les erreurs incrémentielles) dans la section Content Validator (Validateur de contenu) lorsque vous créez ou modifiez une suite d'intégration continue.
Notez les points suivants concernant la validation incrémentielle:
- Le paramètre de validation incrémentielle n'est pas appliqué lorsque la validation de contenu valide la branche de production elle-même (par exemple, lorsque vous y effectuez manuellement des exécutions). Lors de la validation de la branche de production, la Validation de contenu affiche la validation complète des résultats.
Limites de la validation du contenu
Si vous supprimez un modèle ou modifiez son nom, le validateur de contenu ne renvoie plus ces erreurs de contenu "pendentifs", car le modèle ne peut plus être associé au projet en cours de test.