L'exécuteur SQL permet d'accéder directement à votre base de données et d'exploiter cet accès de différentes manières. L'exécuteur SQL vous permet de parcourir facilement les tables de votre schéma, d'utiliser une exploration ad hoc à partir d'une requête SQL, d'exécuter des requêtes descriptives prédéfinies sur vos données, de consulter l'historique de l'exécuteur SQL, de télécharger les résultats, de partager des requêtes, d'ajouter des éléments à un projet LookML en tant que table dérivée et d'effectuer d'autres tâches utiles.
Cette page explique comment créer une table dérivée à l'aide de SQL Runner et comment utiliser SQL Runner pour déboguer des tables dérivées. Consultez ces autres pages de documentation pour obtenir des informations sur les sujets suivants:
- 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 l'endroit idéal pour tester le code SQL et l'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 SQL Runner, 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 Add to Project (Ajouter au projet) ou de l'option Get Derived Table LookML (Obtenir le code LookML de la table dérivée). Ces deux options vous permettent de prendre 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 SQL Runner à 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 de vue 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.
Suivez les étapes ci-dessous pour utiliser l'option Ajouter au projet:
- 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 de roue dentée 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 figure pas déjà, crée un fichier de vue avec le code LookML à partir de la requête SQL Runner, puis ouvre l'explorateur de fichiers IDE pour accéder au nouveau fichier de vue.
- Déplacez le fichier pour l'adapter à 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 SQL Runner consiste à utiliser l'option Get Derived Table LookML (Obtenir le code LookML de la table dérivée) du menu en forme de roue dentée de l'exécuteur SQL. Tout 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. À partir de là, vous pouvez copier vous-même le code LookML à coller 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 SQL Runner:
- 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 de roue dentée et 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 ajoutez-le à votre projet.
Dans la liste déroulante Project (Projet), choisissez 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. Consultez la page Gérer les fichiers et les dossiers LookML pour connaître les conventions d'attribution de noms de fichiers.
Cliquez sur le bouton Add (Ajouter). Looker passe en mode Développement s'il n'y figure pas déjà, crée un fichier de vue avec le code LookML à partir de la requête SQL Runner, puis ouvre l'explorateur de fichiers IDE pour accéder au nouveau fichier de vue.
Déplacez le fichier pour l'adapter à 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
SQL Runner est également un outil utile pour vérifier les erreurs SQL dans la définition d'une table dérivée.
Mise en surbrillance des erreurs de 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 des caractères de l'erreur. Les 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 par un "x". Passez la souris sur le "x" pour en savoir plus sur l'erreur. Une fois ce 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 une erreur provient 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 déterminer l'emplacement de l'erreur. Pour en savoir plus, consultez le post de la communauté Looker Utiliser SQL Runner pour tester des tables dérivées.