Utiliser l'exécuteur SQL pour créer des tables dérivées

SQL Runner permet d'accéder directement à votre base de données de différentes manières. Avec l'exécuteur SQL, vous pouvez facilement parcourir les tables de votre schéma, utiliser une exploration ad hoc à partir d'une requête SQL, exécuter des requêtes descriptives prédéfinies sur vos données, consulter l'historique de l'exécuteur SQL, télécharger les résultats, partager des requêtes, ajouter un projet LookML en tant que table dérivée et effectuer d'autres tâches utiles.

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 les tables dérivées. Consultez ces autres pages de documentation pour en savoir plus sur les sujets suivants:

Créer une table dérivée d'une requête

Il existe plusieurs façons de créer une table dérivée d'une requête dans l'exécuteur SQL.

Ajouter à un projet LookML

SQL Runner est un excellent moyen de tester le code SQL de vos tables dérivées avant de les ajouter à votre modèle. Vous pouvez même obtenir une requête à partir d'un autre outil, la tester dans l'exécuteur SQL, puis l'ajouter à votre projet.

  1. Utilisez l'exécuteur SQL pour créer une requête SQL que vous souhaitez utiliser pour une table dérivée.
  2. Cliquez sur Ajouter au projet dans le menu représenté par une roue dentée en haut à droite.
  3. Sélectionnez le projet auquel vous souhaitez ajouter cette table dérivée.
  4. Saisissez un nom de vue pour la table dérivée.
  5. Cliquez sur Ajouter pour ajouter la requête en tant que table dérivée dans votre projet.
  6. Looker passera en mode développeur (s'il ne l'est pas déjà) et ouvrira la nouvelle vue dérivée dans le projet sélectionné. Si vous avez sélectionné un projet qui utilise l'ancien format LookML basé sur YAML, Looker fournira la table dérivée dans le modèle LookML basé sur YAML. Si vous avez sélectionné un projet qui utilise New LookML, Looker fournira la table dérivée dans New LookML.

Obtenir le LookML pour une table dérivée

Pour créer une table dérivée de votre requête SQL Runner, vous pouvez également utiliser l'option Get Derived Table LookML (Obtenir un style de table dérivée) dans le menu en forme de roue dentée SQL Runner. Comme avec l'option Add to Project (Ajouter au projet), Looker fournira le LookML nécessaire pour transformer votre requête SQL en table dérivée. Vous pouvez ensuite copier vous-même le LookML et le 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 d'une requête SQL Runner:

  1. Utilisez l'exécuteur SQL pour créer une requête SQL que vous souhaitez utiliser pour une table dérivée.
  2. Cliquez sur le menu représenté par une roue dentée et sélectionnez Get Derived Table LookML (Obtenir LookML de table dérivée).
  3. Copiez le LookML généré. Vous pouvez également cliquer sur add it to your project (Ajouter au projet), choisir le projet auquel ajouter la table dérivée, puis saisir le nom de la vue dans View Name (Nom de la vue).

  4. Si vous n'avez pas ajouté la table dérivée à votre projet en cliquant sur Add it to your project (Ajouter la table dérivée à votre projet), ouvrez votre projet et cliquez sur + en haut de la liste des fichiers de projet dans l'IDE Looker. Vous pouvez également cliquer sur le menu d'un dossier pour créer le fichier qu'il contient.

  5. Sélectionnez Créer une vue.

  6. Looker affiche une zone vide en haut de votre liste de vues. Saisissez le nom de la nouvelle vue, puis appuyez sur Entrée. Looker accepte l'utilisation de caractères en majuscules et minuscules, de chiffres, de traits de soulignement et de caractères Unicode dans les noms de fichiers. Si le nom de votre fichier de vue contient des caractères non compatibles avec Looker, ils seront remplacés par des traits de soulignement.

  7. Looker ouvre la nouvelle vue.

  8. Supprimez tout le contenu de la nouvelle vue et collez la table dérivée LookML que vous avez copiée précédemment.

Déboguer à 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 de l'erreur de l'exécuteur SQL

L'exécuteur SQL indique l'emplacement des erreurs dans la commande SQL et indique leur position 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 de caractère de l'erreur. D'autres dialectes de base de données peuvent présenter l'un de ces comportements ou d'autres.

SQL Runner 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 le symbole "&xt". Pointez sur la croix (x) pour afficher plus d'informations sur l'erreur. Une fois ce problème résolu, cliquez sur Exécuter pour vérifier si la requête comporte des erreurs supplémentaires.

Tester l'exécution de tables dérivées avec SQL Runner

Si vous constatez une erreur provenant d'une table dérivée, vous pouvez déterminer la cause de l'erreur en copiant l'instruction SQL dans l'exécuteur SQL et en testant différentes parties de SQL pour affiner l'emplacement de l'erreur. Pour en savoir plus, consultez la rubrique Utiliser l'exécuteur SQL pour tester les tables dérivées de la communauté Looker.