Lorsque vous modifiez votre code LookML, l'IDE Looker vous alerte en cas d'erreurs de syntaxe non résolues dans un seul fichier (consultez la page de documentation Présentation de l'IDE Looker).
Pour effectuer une validation complète du modèle, utilisez l'outil de validation LookML. Certaines erreurs, telles qu'une référence de champ non valide en raison d'une jointure manquante, nécessitent une analyse globale du modèle. Par conséquent, elles ne sont visibles que lorsque le validateur LookML est exécuté. Veillez à valider vos modifications LookML avant de les publier dans l'environnement de production. Bien que la validation ne détecte pas tous les problèmes, comme les problèmes d'autorisation de base de données, elle permet d'éviter la plupart des erreurs.
Le validateur LookML n'analyse que les fichiers LookML qui ont été mis à jour depuis la dernière validation LookML ou les fichiers concernés par les mises à jour :
- Si un paramètre au niveau du modèle change, tout est validé à nouveau.
- Si une vue change, seules les explorations dans lesquelles elle est utilisée sont à nouveau validées.
- Si une exploration change, seule cette exploration est validée à nouveau.
Validation en cours d'exécution
Pour exécuter le validateur LookML, sélectionnez le bouton Valider LookML en haut à droite de l'IDE Looker. ou sélectionnez l'icône Project Health (État du projet) en haut de l'IDE pour ouvrir le panneau Project Health (État du projet), puis cliquez sur l'icône Validate LookML (Valider LookML).
Après avoir exécuté le validateur LookML, vous verrez peut-être une liste d'erreurs et d'autres avertissements que vous devez corriger. Vous pouvez sélectionner n'importe quelle flèche pour développer les listes d'erreurs ou d'avertissements.
Le bouton de validation du panneau État du projet sera de nouveau disponible si vous apportez et enregistrez une autre modification.
Messages de validation
Looker affiche des messages de validation après avoir exécuté la validation sur votre LookML.
Aucune erreur LookML trouvée
Si le programme de validation ne détecte aucun problème, Looker affiche une coche verte avec le texte Aucune erreur LookML trouvée.
Erreurs LookML
Les erreurs LookML sont des problèmes qui peuvent empêcher l'exécution des requêtes. Le nombre entre parenthèses correspond au nombre d'erreurs détectées (neuf dans l'exemple suivant) :
Dans la liste développée des problèmes, vous verrez la raison pour laquelle la validation a échoué. Souvent, si vous cliquez sur l'erreur, vous êtes redirigé directement vers la ligne de code problématique. Un "X" rouge s'affiche. à côté de la ligne. Passez la souris dessus pour obtenir des informations plus détaillées sur les erreurs dans certains cas:
Conseil de l'équipe Chat : L'erreur de validation la plus courante est "Champ inconnu ou inaccessible". Consultez la page des bonnes pratiques intitulée Erreur: champ inconnu ou inaccessible pour connaître les causes du problème et savoir comment y remédier.
Avertissements LookML
Il est possible que les avertissements LookML n'empêchent pas l'exécution d'une requête, mais ils peuvent tout de même entraîner des fonctionnalités défectueuses ou inattendues pour vos utilisateurs. Comme pour les erreurs, le nombre entre parenthèses correspond au nombre d'avertissements détectés (trois avertissements dans l'exemple suivant) :
Comme pour les erreurs LookML, vous pouvez développer les avertissements et accéder directement au code problématique en sélectionnant l'avertissement dans le panneau Project Health (État du projet), puis en pointant sur l'icône X rouge pour afficher plus d'informations:
Déployer vos modifications
Une fois que vous avez vérifié que vos modifications fonctionneront correctement, vous pouvez utiliser l'intégration Git de Looker pour commettre et déployer vos modifications en production.