Le validateur 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 aux champs LookML.
Le programme de validation de contenu CI effectue une validation semblable à celle du programme de validation de contenu Looker standard, avec quelques différences :
Le validateur de contenu CI est compatible avec les éléments suivants :
- Vous pouvez configurer le validateur de contenu CI 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 CI.
- Vous pouvez limiter les résultats du validateur de contenu CI à des dossiers de contenu Looker spécifiques, ou à des modèles et explorations spécifiques dans votre projet LookML. Par défaut, les résultats du validateur de contenu CI sont automatiquement limités à votre projet LookML. La portée du validateur de contenu CI est post-traitement : le validateur s'exécute sur l'ensemble de l'instance Looker, puis filtre les résultats selon la portée que vous avez spécifiée lorsque vous avez créé la suite CI.
Le validateur de contenu Looker standard est compatible avec les éléments suivants :
- Vous ne pouvez exécuter le validateur de contenu Looker que manuellement.
- Vous pouvez limiter le champ d'application du validateur de contenu Looker à des dossiers de contenu Looker spécifiques ou à des projets LookML spécifiques. La portée du validateur de contenu Looker est définie avant la validation : le validateur ne s'exécute que sur les dossiers et projets que vous avez spécifiés lorsque vous avez lancé la validation du contenu.
- Vous pouvez utiliser le validateur 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 CI, consultez la section Options du validateur de contenu sur cette page. Pour savoir comment exécuter le 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, le validateur de contenu fournit le message d'erreur pour chaque Look ou tableau de bord comportant des erreurs, ainsi qu'un lien vers le contenu :
Options du validateur de contenu
Vous pouvez spécifier plusieurs options lorsque vous créez une suite d'intégration continue pour configurer la façon dont le validateur de contenu s'exécute. 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, 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 à 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 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 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 sur le validateur 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 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 correspond au 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 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é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à 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 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 validateur, le validateur de contenu indique chaque exploration qui a été ignorée, car son code SQL compilé n'a subi aucune modification 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 Erreurs incrémentielles uniquement dans la section 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émentale n'est pas appliqué lorsque le Validateur 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, le Validateur de contenu affiche les résultats complets de la validation.
Limites de la validation du contenu
Si vous supprimez un modèle ou modifiez son nom, le validateur de contenu ne renvoie pas ces erreurs de contenu "en suspens", car le modèle ne peut plus être associé au projet testé.