Utiliser l'exécuteur SQL pour créer des requêtes et des explorations

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 exécuter des requêtes dans l'exécuteur SQL, créer des explorations ad hoc et utiliser l'exécuteur SQL pour déboguer des requêtes. Consultez ces autres pages de documentation pour en savoir plus sur les sujets suivants:

Exécuter des requêtes dans l'exécuteur SQL

Pour exécuter une requête sur votre base de données, vous pouvez écrire la requête SQL en partant de zéro, utiliser la fonction Explorer pour créer la requête ou exécuter une requête sur un modèle LookML. Vous pouvez également utiliser l'historique pour réexécuter une requête précédente.

Écrire une requête SQL en partant de zéro

Vous pouvez utiliser SQL Runner pour écrire et exécuter vos propres requêtes SQL sur votre base de données. Looker transmet votre requête à votre base de données exactement comme vous l'avez écrite. Par conséquent, assurez-vous que la syntaxe de votre requête SQL est valide pour le dialecte de votre base de données. Par exemple, chaque dialecte possède des fonctions SQL légèrement différentes avec des paramètres spécifiques qui doivent lui être transmis.

  1. Cliquez dans la zone "Requête SQL" et saisissez votre commande SQL.
  2. Vous pouvez également double-cliquer sur le nom ou le champ d'une table dans la liste des champs pour l'inclure à la position du curseur.
  3. Cliquez sur Exécuter pour exécuter la requête sur votre base de données.
  4. Consultez les résultats dans la zone "Résultats". L'exécuteur SQL charge jusqu'à 5 000 lignes de l'ensemble de résultats de la requête. Pour les dialectes SQL compatibles avec la diffusion en flux continu, vous pouvez télécharger les résultats pour voir l'ensemble des résultats.

Certains programmes SQL vous permettent d'exécuter plusieurs requêtes en une série. Cependant, vous ne pouvez exécuter qu'une seule requête à la fois dans SQL Runner. SQL Runner a également une limite de 65 535 caractères pour les requêtes, y compris les espaces.

Lorsqu'une requête vous convient, vous pouvez ensuite l'ajouter à un projet, obtenir le LookML pour une table dérivée ou partager la requête.

Vous pouvez également utiliser SQL Runner pour jouer avec de nouvelles requêtes ou tester des requêtes existantes. La mise en surbrillance des erreurs de l'exécuteur SQL permet de tester et de déboguer les requêtes.

Utiliser une requête Explorer pour créer une requête SQL

Vous pouvez également utiliser une fonction Explorer pour créer une requête, puis obtenir la commande SQL à utiliser dans l'exécuteur SQL:

  1. Dans Explorer, cliquez sur l'onglet SQL dans la barre Données.
  2. Sélectionnez le texte de la requête SQL et copiez-le dans l'exécuteur SQL.
  3. Cliquez sur Ouvrir dans l'exécuteur SQL ou Expliquer dans l'exécuteur SQL pour ouvrir la requête dans l'exécuteur SQL.

Lorsqu'une requête est ajoutée à la zone "Requête SQL" de l'exécuteur SQL, vous pouvez cliquer sur Exécuter pour l'interroger. Vous pouvez également modifier la requête, puis exécuter la nouvelle requête.

Créer des visualisations avec l'exécuteur SQL

Si votre administrateur Looker a activé la fonctionnalité expérimentale Exécuteur SQL, vous pouvez créer des visualisations directement dans l'exécuteur SQL.

Lorsque l'option SQL Runner Vis est activée, les panneaux SQL Runner sont réorganisés. Le panneau de visualisation s'affiche en haut, le panneau des résultats au milieu et le panneau des requêtes en bas.

  1. Après avoir créé et exécuté une requête SQL, vous pouvez ouvrir l'onglet Visualisation pour afficher la visualisation et choisir un type de visualisation, comme vous le feriez sur la page "Explorer".
  2. Vous pouvez modifier la visualisation à l'aide du menu Paramètres.
  3. Vous pouvez partager les visualisations créées avec l'exécuteur SQL en partageant l'URL. Toutes les personnalisations que vous effectuez à l'aide du menu Paramètres de la visualisation sont enregistrées, et le lien ne change pas.

Voici quelques points à retenir concernant le fonctionnement des visualisations de l'exécuteur SQL:

  • Le tableau des résultats et la visualisation interprètent chaque champ numérique comme une mesure.
  • Le nom complet du champ est toujours utilisé dans la table de résultats et la visualisation. Par conséquent, l'option Afficher le nom complet du champ dans le menu Paramètres est inactive.
  • Pour utiliser des champs personnalisés, des calculs de tableaux, des tableaux croisés dynamiques, des totaux de colonnes et des sous-totaux, explorez votre requête SQL Runner.
  • Les visualisations de cartes (régions) statiques ne sont pas compatibles avec les visualisations SQL Runner. Toutefois, celles qui utilisent des données de latitude et de longitude (visualisation de cartes et de cartes statiques (points)) sont compatibles.
  • Les visualisations de la timeline ne sont pas compatibles avec les visualisations de l'exécuteur SQL.

Rotation de dimensions

Vous pouvez définir les résultats de la requête sur pivot selon une ou plusieurs dimensions dans les visualisations de l'exécuteur SQL. Pour faire pivoter un champ:

  1. Cliquez sur le menu représenté par une roue dentée dans la zone Résultats pour afficher les options de la colonne.
  2. Cliquez sur Colonne pivot.

Les résultats de tableau croisé dynamique s'affichent dans la visualisation de l'exécuteur SQL:

Les résultats de la zone Résultats ne s'affichent pas de manière croisée.

Pour annuler le tableau croisé dynamique de résultats, cliquez sur le menu représenté par une roue dentée qui pivote, puis sélectionnez Supprimer le tableau croisé dynamique :

Modifier le type de champ

Lorsque vous affichez les résultats et la visualisation de votre requête, SQL Runner interprète automatiquement tout champ numérique comme une mesure et tout champ non numérique comme une dimension. Vous pouvez remplacer le type de champ par défaut et convertir une dimension en mesure, ou inversement:

  1. Cliquez sur le menu représenté par une roue dentée dans la zone Résultats pour afficher les options de la colonne.
  2. Cliquez sur Convertir en dimension ou Convertir en mesure pour modifier le type de champ.

La visualisation affiche le nouveau type de champ:

Exécuter une requête sur un modèle LookML

Vous pouvez utiliser SQL Runner pour écrire et exécuter des requêtes SQL sur un modèle LookML, plutôt que directement sur votre base de données. Lorsque vous créez votre requête sur un modèle, vous pouvez utiliser des opérateurs de substitution LookML, tels que ${view_name.field_name} ou ${view_name.SQL_TABLE_NAME}. Vous pouvez ainsi gagner du temps lors de la création d'une requête pour résoudre les problèmes d'une table dérivée, par exemple.

Looker résout les substitutions LookML, puis transmet votre requête à votre base de données. Elle doit donc être en SQL valide pour le dialecte de votre base de données. Par exemple, chaque dialecte possède des fonctions SQL légèrement différentes avec des paramètres spécifiques qui doivent lui être transmis.

Pour exécuter une requête sur votre modèle LookML dans l'exécuteur SQL:

  1. Cliquez sur l'onglet Modèle.
  2. Sélectionnez le modèle que vous souhaitez interroger.
  3. Cliquez dans la zone "Requête SQL", puis saisissez votre requête SQL à l'aide des champs LookML.
  4. Vous pouvez également double-cliquer sur une vue de la liste pour l'inclure dans votre requête à l'emplacement du curseur.
  5. Pour afficher la liste des champs d'une vue, cliquez sur la vue dans la section Vues. Vous pouvez également double-cliquer sur un champ de la liste pour l'inclure à votre requête à l'emplacement du curseur.
  6. Dans la zone Requête SQL préparée, vous pouvez afficher la requête SQL générée une fois que les substitutions LookML ont été converties en SQL.
  7. Cliquez sur Run (Exécuter) pour exécuter la requête sur votre modèle.
  8. Consultez les résultats dans la zone Résultats. L'exécuteur SQL charge jusqu'à 5 000 lignes de l'ensemble de résultats de la requête. Pour les dialectes SQL compatibles avec la diffusion en flux continu, vous pouvez télécharger les résultats pour voir l'ensemble des résultats.

Lorsqu'une requête vous convient, vous pouvez ensuite l'ajouter à un projet, obtenir le LookML pour une table dérivée ou partager la requête.

Vous pouvez également utiliser SQL Runner pour jouer avec de nouvelles requêtes, tester des requêtes existantes ou ouvrir une exploration des résultats. La mise en surbrillance des erreurs de l'exécuteur SQL permet de tester et de déboguer les requêtes.

Afficher un LookML d'un champ depuis SQL Runner

Dans la liste des champs de l'onglet Modèle, vous pouvez également voir LookML pour un champ. Pointez sur le champ dans la liste des champs, puis cliquez sur l'icône Looker à droite du nom du champ:

Looker ouvre l'IDE LookML et charge le fichier à l'emplacement du champ.

Historique de l'exécuteur SQL

Vous pouvez également consulter l'historique récent de toutes les requêtes que vous avez exécutées dans l'exécuteur SQL.

Pour afficher votre historique, cliquez sur l'onglet Historique en haut du volet de navigation. SQL Runner affiche toutes les requêtes exécutées sur la connexion à la base de données. La couleur rouge indique une requête qui n'a pas été exécutée en raison d'une erreur.

Cliquez sur une requête de l'historique pour la renseigner dans l'exécuteur SQL, puis cliquez sur Run (Exécuter) :

Tri de votre requête

Un ordre de tri est indiqué par une flèche vers le haut ou vers le bas à côté du nom du champ trié, selon que les résultats sont classés par ordre croissant ou décroissant. Vous pouvez effectuer un tri sur plusieurs colonnes en maintenant la touche Maj enfoncée, puis en cliquant sur les en-têtes de colonne, dans l'ordre selon lequel vous souhaitez les trier. L'ordre de tri d'un champ est également indiqué par un nombre qui distingue son ordre de tri par rapport aux autres champs, par une flèche à côté du nom du champ qui indique l'ordre de tri (croissant ou décroissant) et par une fenêtre pop-up qui s'affiche lorsque vous pointez sur le nom d'un champ.

Pour obtenir plus d'informations et des exemples, consultez la section Trier les données de la page de documentation Explorer les données dans Looker.

Requêtes de partage

Vous pouvez partager une requête dans l'exécuteur SQL avec un autre utilisateur disposant d'un accès à l'exécuteur SQL. Pour partager une requête, il vous suffit de copier l'URL dans la barre d'adresse:

Téléchargement des résultats...

Une fois que vous avez exécuté votre requête SQL, vous pouvez télécharger les résultats dans différents formats.

  1. Rédigez une requête dans le champ Requête SQL. (Vous n'avez pas besoin d'exécuter la requête dans l'exécuteur SQL à ce stade.)
  2. Sélectionnez Télécharger dans le menu en forme de roue dentée en haut à droite.
  3. Sélectionnez le format de téléchargement (fichier texte, CSV, JSON, etc.).

  4. Cliquez sur Ouvrir dans le navigateur pour afficher les résultats dans une nouvelle fenêtre, ou cliquez sur Télécharger pour télécharger les résultats dans un fichier sur votre ordinateur.

    Lorsque vous cliquez sur Ouvrir dans le navigateur ou Télécharger, Looker réexécute la requête, puis effectue le téléchargement.

Pour les dialectes SQL compatibles avec la diffusion en flux continu, l'option Download (Exécuter) de SQL Runner permet de télécharger l'ensemble des résultats. Pour les dialectes SQL qui ne sont pas compatibles avec la diffusion en flux continu, l'option Download (Exécuter) de SQL Runner ne télécharge que les lignes de la requête affichées dans la section Results (Résultats) (5 000 lignes maximum).

Copier des valeurs de colonne

Vous pouvez copier les valeurs de colonne de la section Results (Résultats) dans SQL Runner. Cliquez sur le menu représenté par une roue dentée pour copier les valeurs dans le presse-papiers. Vous pouvez ensuite coller les valeurs des colonnes dans un fichier texte, un document Excel ou un autre emplacement.

Si votre administrateur Looker a activé la fonctionnalité SQL Runner Vis (Ateliers SQL), vous avez également accès à d'autres options dans le menu en forme de roue dentée:

Vous pouvez également déplacer, épingler et redimensionner manuellement les colonnes du tableau des résultats.

Estimations des coûts pour les requêtes SQL Runner

Pour les connexions BigQuery, MySQL, Amazon RDS pour MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL pour PostgreSQL et Microsoft Azure PostgreSQL, SQL Runner fournit une estimation du coût de la requête. Une fois que vous avez saisi la requête SQL, SQL Runner calcule la quantité de données requise par la requête et affiche les informations à proximité du bouton Run (Exécuter).

Pour les connexions BigQuery, MySQL et Amazon RDS, les estimations de coût sont toujours activées. Pour les connexions à la base de données Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL pour PostgreSQL et Microsoft Azure PostgreSQL, vous devez activer l'option Coût estimé. Vous pouvez activer l'estimation des coûts lorsque vous créez la connexion. Pour les connexions existantes, vous pouvez modifier la connexion depuis la page Connexions dans la section Base de données du panneau Admin de Looker.

Créer une exploration ad hoc

SQL Runner vous permet d'obtenir rapidement des insights sur les données en créant une exploration ad hoc pour une requête ou une table de base de données SQL. Looker vous permet de sélectionner des champs, d'ajouter des filtres, de visualiser les résultats et de créer des requêtes SQL.

Il existe deux façons d'ouvrir une exploration ad hoc à partir de l'exécuteur SQL:

  • Explorer les résultats d'une requête de l'exécuteur SQL
  • Explorer à partir de la liste de tables de l'exécuteur SQL

Explorer des résultats de requête avec l'exécuteur SQL

SQL Runner vous permet d'ouvrir une requête Explorer à partir d'une requête SQL. Cette action crée une exploration temporaire à partir de la requête écrite dans l'exécuteur SQL. Cela vous permet de tester ce qui est renvoyé par la requête et de visualiser les résultats. Il peut être utilisé pour n'importe quelle requête, mais il est particulièrement utile pour tester les requêtes que vous prévoyez d'utiliser pour les tables dérivées.

Si votre administrateur Looker a activé les fonctionnalités expérimentales Exécuteur SQL, vous pouvez créer des visualisations directement dans l'exécuteur SQL.

  1. Utilisez l'exécuteur SQL pour créer la requête SQL que vous souhaitez utiliser.
  2. Cliquez sur Explorer dans le menu représenté par une roue dentée en haut à droite. Vous accédez à une nouvelle exploration, dans laquelle vous pouvez explorer la requête SQL comme s'il s'agissait d'une table enregistrée dans votre modèle.
  3. Vous pouvez copier l'URL de cette exploration pour la partager.
  4. Pour ajouter cette requête en tant que table dérivée directement dans votre projet, cliquez sur Add View to Project (Ajouter une vue au projet).

Créer des champs personnalisés lors de l'exploration dans l'exécuteur SQL

Si vous avez accès à la fonctionnalité Champs personnalisés, vous pouvez utiliser des champs personnalisés pour visualiser des champs non modélisés dans l'exécuteur SQL. Comme décrit dans la section précédente, cliquez sur Explorer dans le menu représenté par une roue dentée. Ensuite, dans l'outil de sélection de champs:

Explorer une table répertoriée dans l'exécuteur SQL

Utilisez l'option Explore Table (Explorer la table) dans l'onglet Database (Base de données) pour créer une exploration ad hoc pour n'importe quelle table de la connexion. Vous pouvez ainsi utiliser Looker sur une table avant de la modéliser, en l'explorant comme une vue LookML.

Lorsque vous ouvrez la table "Explorer", vous pouvez décider d'ajouter la table à votre projet. Vous pouvez également utiliser l'onglet SQL de l'onglet "Explorer" pour voir les requêtes SQL que Looker envoie à la base de données, puis utiliser le bouton Open in SQL Runner (Ouvrir dans l'exécuteur SQL) pour renvoyer la requête dans l'exécuteur SQL.

  1. Cliquez sur l'onglet Base de données.
  2. Dans l'exécuteur SQL, cliquez sur l'icône en forme de roue dentée d'une table, puis sélectionnez Explorer la table.
  3. Looker génère un modèle temporaire avec une vue pour la table, puis affiche l'exploration.
  4. Looker fournit un champ de dimension pour chaque colonne de la table. (de la même manière que Looker génère un modèle au début d'un projet).
  5. Looker inclut automatiquement des périodes pour tous les champs de date.
  6. Looker inclut également une mesure de décompte.

Lorsque vous utilisez l'option Explorer la table, aucun fichier LookML n'est associé à l'exploration. Il s'agit simplement d'une vue ad hoc de la table.

Déboguer à l'aide de l'exécuteur SQL

SQL Runner est également un outil utile pour vérifier les erreurs SQL dans les requêtes.

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.

Utiliser l'exécuteur SQL pour vérifier les erreurs dans l'outil Explorers

Si vous rencontrez des erreurs de syntaxe SQL dans une exploration, vous pouvez utiliser l'exécuteur SQL pour déterminer l'emplacement de l'erreur et son type (par exemple, faute d'orthographe ou commandes manquantes).

  1. Dans l'onglet "Explorer", cliquez sur l'onglet SQL dans la barre de données.
  2. Cliquez sur Open in SQL Runner (Ouvrir dans l'exécuteur SQL).

Cette commande copie le code SQL généré par Explorer vers l'exécuteur SQL. Comme indiqué ci-dessus, l'exécuteur SQL signale l'emplacement des erreurs dans la commande SQL et indique leur position dans le message d'erreur. Vous pouvez ensuite effectuer des modifications et réexécuter la requête dans l'exécuteur SQL jusqu'à ce que vous ayez corrigé les erreurs.

Utiliser l'exécuteur SQL pour vérifier les erreurs dans les tables dérivées

Pour en savoir plus sur l'utilisation de l'exécuteur SQL pour vérifier les erreurs SQL dans les tables dérivées, consultez l'article Utiliser l'exécuteur SQL pour tester les tables dérivées de la communauté Looker.