Valider votre code LookML

Lorsque vous modifiez votre code LookML, l'IDE de Looker vous avertit de toute erreur de syntaxe non résolue dans un seul fichier (voir la page de documentation Présentation de l'IDE de Looker).

Pour effectuer une validation complète du modèle, utilisez l'outil de validation LookML. Certaines erreurs, comme une référence de champ non valide en raison d'une jointure manquante, nécessitent un examen global du modèle et ne s'affichent donc que lorsque l'outil de validation 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.

Remarque :Le vérificateur LookML ne doit pas être confondu avec le vérificateur de contenu, qui vérifie si les modifications que vous avez apportées risquent de corrompre des looks enregistrés.

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 validées à nouveau.
• Si une exploration change, seule cette exploration est validée à nouveau.

Conseil :Si vous remarquez que la validation LookML prend beaucoup de temps, commencez par vérifier le paramètre include dans votre fichier de modèle. Si vous incluez tous vos fichiers de vue (include: "*.view"), le programme de validation de LookML devra tous les vérifier, ce qui peut affecter les performances. Dans ce cas, mettez à jour le paramètre include du fichier de modèle afin que seuls les fichiers de vue nécessaires soient inclus.

Exécuter la validation

Pour exécuter le validateur LookML, sélectionnez le bouton Valider LookML en haut à droite de l'IDE Looker. Vous pouvez également sélectionner l'icône État du projet en haut de l'IDE pour ouvrir le panneau État du projet, puis cliquer sur l'icône 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 code LookML.

Remarque :Les tableaux de bord LookML affichent des messages d'information plutôt que des avertissements dans la barre latérale lorsque la localisation permissive est activée.

Aucune erreur LookML trouvée

Si aucun problème n'est détecté par l'outil de validation, Looker affiche une coche verte avec le message Aucune erreur LookML détecté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 trouverez 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 apparaît à côté de la ligne. Pointez dessus pour obtenir des informations plus détaillées sur l'erreur 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 sur l'erreur "Champ inconnu ou inaccessible" pour connaître les causes et les solutions.

Avertissements LookML

Les avertissements LookML peuvent ne pas empêcher l'exécution d'une requête, mais ils peuvent tout de même entraîner des fonctionnalités défectueuses ou non intentionnelles 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 au code du problème en sélectionnant l'avertissement dans le panneau État du projet, puis en pointant sur l'icône rouge X 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.

Remarque :Si vous modifiez des noms de champs utilisés comme filtres dans vos présentations ou tableaux de bord, n'oubliez pas de consulter la section Filtres de vos présentations et tableaux de bord planifiés et d'actualiser les filtres afin que vos modifications soient prises en compte. Si un envoi de contenu planifié inclut des filtres qui ne fonctionnent plus (en cas de changement du champ référencé, par exemple), il est possible que l'envoi planifié présente des données non filtrées.