L'exécuteur SQL fournit un accès direct à la base de données, que vous pouvez utiliser pour créer et déboguer des tables dérivées pour vos projets LookML. Utilisez l'exécuteur SQL pour définir de nouvelles tables dérivées et résoudre les problèmes liés à celles existantes. Vous pouvez ainsi garantir l'exactitude des données et améliorer votre workflow de développement. Ce guide explique comment utiliser l'exécuteur SQL pour ces tâches.
Cette page explique comment créer une table dérivée à l'aide de l'exécuteur SQL et comment utiliser l'exécuteur SQL pour déboguer des tables dérivées. Pour en savoir plus, consultez les pages de documentation suivantes :
- Principes de base de l'exécuteur SQL
- Utiliser l'exécuteur SQL pour créer des requêtes et des explorations
- Gérer les fonctions de base de données avec l'exécuteur SQL
Ajouter une requête d'exécuteur SQL à un projet LookML
L'exécuteur SQL est un excellent outil pour tester le code SQL à utiliser comme table dérivée dans votre projet LookML. Vous pouvez même obtenir une requête SQL à partir d'un autre outil, la tester dans l'exécuteur SQL, puis l'ajouter à votre projet LookML.
Une fois que vous avez créé une requête SQL dans l'exécuteur SQL, vous pouvez créer une table dérivée à partir de la requête à l'aide de l'option Ajouter au projet ou Obtenir le code LookML de la table dérivée. Ces deux options vous permettent d'utiliser une requête dans l'exécuteur SQL et de l'ajouter à votre projet LookML. Pour en savoir plus, consultez les sections suivantes.
Ajouter au projet
L'option Ajouter au projet est le moyen le plus simple d'ajouter une requête d'exécuteur SQL à votre projet :
L'option Ajouter au projet vous permet de sélectionner un projet LookML. Looker crée ensuite automatiquement un fichier de vue avec la requête dans le projet sélectionné. Si vous préférez créer manuellement le fichier d'affichage et ajouter vous-même le code LookML de la requête, vous pouvez utiliser l'option Obtenir le code LookML de la table dérivée.
Pour utiliser l'option Ajouter au projet , procédez comme suit :
- Utilisez l'exécuteur SQL pour créer une requête SQL que vous souhaitez utiliser pour une table dérivée.
- Cliquez sur Ajouter au projet dans le menu en forme d'engrenage en haut à droite.
- Sélectionnez le projet auquel vous souhaitez ajouter cette table dérivée.
- Saisissez un nom de vue pour la table dérivée.
- Cliquez sur Ajouter pour ajouter la requête en tant que table dérivée dans votre projet. Looker passe en mode Développement s'il n'y est pas déjà, crée un fichier de vue avec le code LookML de la requête d'exécuteur SQL, puis ouvre l'explorateur de fichiers de l'IDE dans le nouveau fichier de vue.
- Déplacez le fichier en fonction de l'organisation des fichiers de votre projet.
- Validez le code LookML et déployez vos modifications en production.
Obtenir le code LookML de la table dérivée
Une autre façon de créer une table dérivée à partir de votre requête d'exécuteur SQL consiste à utiliser l'option Obtenir le code LookML de la table dérivée dans le menu en forme d'engrenage de l'exécuteur SQL. Comme avec l'option Ajouter au projet, Looker fournit le code LookML nécessaire pour transformer votre requête SQL en table dérivée. Vous pouvez ensuite copier le code LookML pour le coller vous-même dans votre projet, ce qui est utile si vous souhaitez remplacer une table dérivée existante.
Pour créer une table dérivée à partir d'une requête d'exécuteur SQL :
- Utilisez l'exécuteur SQL pour créer une requête SQL que vous souhaitez utiliser pour une table dérivée.
- Cliquez sur le menu en forme d'engrenage, puis sélectionnez Obtenir le code LookML de la table dérivée.
Dans la fenêtre pop-up Obtenir le code LookML de la table dérivée, cliquez sur le lien Ajouter à votre projet.
Utilisez la liste déroulante Projet pour choisir le projet auquel vous souhaitez ajouter la table dérivée.
Saisissez un nom pour la nouvelle vue dans le champ Nom de la vue. Pour connaître les conventions de dénomination des fichiers, consultez la page Gérer les fichiers et dossiers LookML.
Cliquez sur le bouton Ajouter. Looker passe en mode Développement s'il n'y est pas déjà, crée un fichier de vue avec le code LookML de la requête d'exécuteur SQL, puis ouvre l'explorateur de fichiers de l'IDE dans le nouveau fichier de vue.
Déplacez le fichier en fonction de l'organisation des fichiers de votre projet.
Validez le code LookML et déployez vos modifications en production.
Débogage à l'aide de l'exécuteur SQL
L'exécuteur SQL est également un outil utile pour vérifier les erreurs SQL dans la définition d'une table dérivée.
Mise en évidence des erreurs dans l'exécuteur SQL
L'exécuteur SQL met en évidence l'emplacement des erreurs dans la commande SQL et inclut la position de l'erreur dans le message d'erreur.
Les informations de position fournies varient en fonction du dialecte de la base de données. Par exemple, MySQL fournit le numéro de ligne contenant l'erreur, tandis que Redshift fournit la position du caractère de l'erreur. D'autres dialectes de base de données peuvent avoir l'un de ces comportements ou d'autres.
L'exécuteur SQL met également en évidence l'emplacement de la première erreur de syntaxe dans la commande SQL en la soulignant en rouge et en marquant la ligne avec un "x". Pointez sur le "x" pour afficher plus d'informations sur l'erreur. Une fois le problème résolu, cliquez sur Exécuter pour voir s'il y a d'autres erreurs dans la requête.
Utiliser l'exécuteur SQL pour tester des tables dérivées
Si vous voyez une erreur provenant d'une table dérivée, vous pouvez en déterminer la cause en copiant l'instruction SQL dans l'exécuteur SQL et en testant différentes parties du code SQL pour affiner l'emplacement de l'erreur. Pour en savoir plus, consultez l'article de la communauté Looker Utiliser l'exécuteur SQL pour tester des tables dérivées.