La validation de contenu d'intégration continue (CI) identifie les tableaux de bord et les Looks qui comportent des erreurs. Ces erreurs sont souvent dues à des références manquantes à des champs LookML.
La validation de contenu d'intégration continue effectue une validation semblable à celle de la validation de contenu Looker standard, avec quelques différences :
La validation de contenu d'intégration continue est compatible avec les éléments suivants :
- Vous pouvez configurer la validation de contenu d'intégration continue pour qu'elle s'exécute automatiquement selon une programmation, 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 de la validation de contenu d'intégration continue à des dossiers de contenu Looker spécifiques, ou à des modèles et des explorations spécifiques dans votre projet LookML. Par défaut, les résultats de la validation de contenu d'intégration continue sont automatiquement limités à votre projet LookML. La limitation de la validation de contenu d'intégration continue est un post-traitement : le programme de validation s'exécute sur l'ensemble de l'instance Looker, puis filtre les résultats en fonction de la limitation que vous avez spécifiée lorsque vous avez créé la suite d'intégration continue.
La validation de contenu Looker standard est compatible avec les éléments suivants :
- Vous ne pouvez exécuter la validation de contenu Looker que manuellement.
- Vous pouvez limiter la validation de contenu Looker à des dossiers de contenu Looker spécifiques ou à des projets LookML spécifiques. La limitation de la validation de contenu Looker se produit avant la validation : le validateur ne s'exécute que sur les dossiers et les projets que vous avez spécifiés lorsque vous avez lancé la validation de contenu.
- Vous pouvez utiliser la validation de contenu Looker pour remplacer les noms des champs, des vues, des explorations et des modèles, pour supprimer des champs et pour supprimer des Looks.
Pour en savoir plus sur les options que vous pouvez configurer lorsque vous créez ou modifiez une suite d'intégration continue, consultez la section Options de la validation de contenu de cette page. Pour en savoir plus sur l'exécution de la validation 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, la validation de contenu fournit le message d'erreur pour chaque Look ou tableau de bord comportant 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 de la validation 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 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 à interroger pour spécifier l'exploration et les modèles que vous souhaitez inclure dans la validation de 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 les éléments suivants : 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 Validation SQL.
Explorations à exclure
Par défaut, la validation 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 l'exploration et les modèles que vous souhaitez exclure de la validation de 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 Validation SQL.
Dossiers à valider
Vous pouvez limiter la validation de contenu à des dossiers de contenu spécifiques de votre instance Looker en spécifiant un ID de dossier ou une liste d'ID de dossiers 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 dossiers séparés par une virgule dans le champ Dossiers à exclure.
Exclure le contenu des dossiers personnels
Si vous souhaitez que la 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é, la validation de contenu ignore le contenu des dossiers personnels de votre instance Looker.
Validation incrémentielle
La validation incrémentale 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à en production. La validation incrémentale aide les développeurs à trouver et à corriger les erreurs dont ils sont responsables sans être distraits par les erreurs existantes dans le projet. Elle peut également accélérer la validation, en particulier pour les projets LookML qui contiennent de nombreuses explorations.
Dans les résultats du programme de validation, la validation de contenu indique chaque exploration qui a été 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 obtenir 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 programme de validation de contenu en cochant la case Seulement les erreurs incrémentielles dans la section Programme de validation 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émentale 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 les résultats complets de la validation.
Limites de la validation de contenu
Si vous supprimez un modèle ou que vous modifiez son nom, la validation de contenu ne renvoie pas ces erreurs de contenu "en attente", car le modèle ne peut plus être associé au projet en cours de test.