Utiliser SQL Runner pour créer des requêtes et des explorations

SQL Runner permet d'accéder directement à votre base de données et d'exploiter cet accès de différentes manières. Avec SQL Runner, 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é-écrites sur vos données, consulter votre historique SQL Runner, télécharger les résultats, partager des requêtes, ajouter des éléments à 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 SQL Runner, créer des explorations ad hoc et utiliser SQL Runner 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 à partir de zéro, utiliser une exploration 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 à partir 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 telle que vous l'avez écrite. Assurez-vous donc que la syntaxe de votre requête SQL est valide pour votre dialecte de 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 être transmis à la fonction.

  1. Saisissez une requête SQL dans la zone de texte située sous la barre Requête.
  2. Si vous le souhaitez, vous pouvez sélectionner un nom de table ou un champ dans la liste des champs pour l'inclure dans votre requête à l'emplacement du curseur.
  3. Sélectionnez Exécuter pour exécuter la requête sur votre base de données.
  4. Affichez les résultats dans la zone Résultats. SQL Runner charge jusqu'à 5 000 lignes de l'ensemble de résultats de la requête. Pour les dialectes SQL compatibles avec le streaming, vous pouvez télécharger les résultats pour afficher l'ensemble complet des résultats.

Certains programmes SQL vous permettent d’exécuter plusieurs requêtes en série. Toutefois, 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, espaces blancs compris.

Après avoir exécuté une requête, vous pouvez l'ajouter à un projet, obtenir le code LookML d'une table dérivée ou partager la requête.

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

Utilisation d'une exploration pour créer une requête SQL

Vous pouvez également utiliser une exploration pour créer une requête, puis obtenir la commande SQL correspondante à utiliser dans SQL Runner:

  1. Dans une exploration, sélectionnez l'onglet SQL dans la barre Données.
  2. La requête SQL s'affiche sous la barre Données.
  3. Sélectionnez Ouvrir dans SQL Runner ou Expliquer dans SQL Runner pour ouvrir la requête dans SQL Runner.

Une fois la requête ajoutée dans la zone de texte située sous la barre Requête, vous pouvez sélectionner Exécuter pour interroger la base de données. Vous pouvez également modifier la requête, puis exécuter la nouvelle.

Créer des visualisations avec SQL Runner

Si votre administrateur Looker a activé la fonctionnalité de laboratoire SQL Runner Vis, vous pouvez créer des visualisations directement dans SQL Runner.

Lorsque SQL Runner Vis est activé, 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 de requête 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 des visualisations créées avec SQL Runner en partageant l'URL. Toutes les personnalisations que vous effectuez à l'aide du menu Paramètres de la visualisation seront enregistrées et le lien ne sera pas modifié.

Il y a quelques éléments à garder à l'esprit sur le fonctionnement des visualisations SQL Runner:

  • Le tableau de résultats et la visualisation interprètent n'importe quel 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 table, des tableaux croisés dynamiques, des totaux de colonnes et des sous-totaux, explorez votre requête SQL Runner.
  • Les visualisations de cartes statiques (régions) ne sont pas compatibles avec les visualisations SQL Runner, mais les cartes qui utilisent des données de latitude et de longitude (visualisations de cartes et de cartes statiques (points)) sont prises en charge.
  • Les visualisations de chronologie ne sont pas prises en charge par les visualisations SQL Runner.

Rotation de dimensions

Vous pouvez modifier les résultats de la requête pour effectuer une pivot en fonction d'une ou de plusieurs dimensions dans les visualisations SQL Runner. Pour croiser un champ:

  1. Sélectionnez le menu en forme de roue dentée d'une colonne dans la zone Résultats pour afficher les options de colonne.
  2. Sélectionnez Colonne croisée.

Les résultats croisés s'affichent dans la visualisation SQL Runner.

Les résultats de la zone Résultats ne sont pas affichés sous forme de tableau croisé dynamique.

Pour annuler le tableau croisé dynamique, sélectionnez le menu en forme de roue dentée de la colonne pivotée, puis Annuler le tableau croisé dynamique.

Modifier le type de champ

Lors de l'affichage des résultats et de 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. Pour remplacer le type de champ par défaut et convertir une dimension en mesure (ou vice versa), procédez comme suit:

  1. Sélectionnez le menu en forme de roue dentée d'une colonne dans la zone Résultats pour afficher les options de colonne.
  2. Sélectionnez 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

SQL Runner vous permet d'écrire et d'exécuter des requêtes SQL sur un modèle LookML, plutôt que directement sur votre base de données. Lorsque vous construisez 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}. Cela permet de gagner du temps lors de la construction d'une requête visant à corriger une table dérivée, par exemple.

Looker résout toutes les substitutions LookML, puis transmet votre requête à votre base de données. La requête doit donc être en SQL valide pour votre dialecte de 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 être transmis à la fonction.

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

  1. Sélectionnez l'onglet Modèle.
  2. Sélectionnez le modèle que vous souhaitez interroger.
  3. Dans la zone de texte située sous la barre Données, saisissez votre requête SQL en utilisant les champs LookML.
  4. Si vous le souhaitez, vous pouvez sélectionner une vue dans la liste des vues pour l'inclure dans votre requête à l'emplacement du curseur.
  5. Pour afficher la liste des champs d'une vue, sélectionnez la vue dans la section Vues. Vous pouvez éventuellement sélectionner un champ dans la liste des champs pour l'inclure dans 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é traduites en SQL.
  7. Sélectionnez Exécuter pour exécuter la requête sur votre modèle.
  8. Affichez les résultats dans la zone Résultats. SQL Runner charge jusqu'à 5 000 lignes de l'ensemble de résultats de la requête. Pour les dialectes SQL compatibles avec le streaming, vous pouvez télécharger les résultats pour afficher l'ensemble complet des résultats.

Vous pouvez utiliser SQL Runner pour tester de nouvelles requêtes, tester des requêtes existantes ou ouvrir une nouvelle exploration à partir des résultats. La mise en surbrillance des erreurs dans SQL Runner permet de tester et de déboguer les requêtes.

Si vous avez une requête qui vous intéresse, vous pouvez la partager et même l'ajouter à un projet LookML.

Afficher le code LookML d'un champ depuis SQL Runner

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

Looker ouvre l'IDE LookML et charge le fichier dans lequel le champ est défini.

Historique de l'exécuteur SQL

Vous pouvez également afficher un historique récent de toutes les requêtes que vous avez exécutées dans SQL Runner.

Pour consulter votre historique, sélectionnez 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. Le rouge indique une requête qui n'a pas été exécutée en raison d'une erreur.

Sélectionnez une requête dans l'historique pour la renseigner dans SQL Runner, puis sélectionnez Run (Exécuter) pour la réexécuter.

Trier votre requête

L'ordre de tri d'un tableau 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 dans l'ordre croissant ou décroissant. Vous pouvez trier les données selon plusieurs colonnes en maintenant la touche Maj enfoncée, puis en sélectionnant les en-têtes de colonne dans l'ordre dans lequel vous souhaitez qu'ils soient triés. 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 indiquant l'ordre de tri (croissant ou décroissant) et par une fenêtre pop-up qui apparaît lorsque vous pointez sur le nom d'un champ.

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

Partager des requêtes

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, copiez l'URL affichée dans la barre d'adresse de votre navigateur.

Télécharger les résultats

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

  1. Saisissez une requête dans la zone Requête SQL. (Il n'est pas nécessaire d'exécuter la requête dans SQL Runner à ce stade.)
  2. Sélectionnez Télécharger dans le menu représenté par une roue dentée en haut à droite.
  3. Sélectionnez le format du fichier à télécharger (fichier texte, CSV, JSON, etc.).

  4. Sélectionnez Ouvrir dans un navigateur pour afficher les résultats dans une nouvelle fenêtre du navigateur ou Télécharger pour télécharger les résultats dans un fichier sur votre ordinateur.

    Lorsque vous sélectionnez Ouvrir dans le navigateur ou Télécharger, Looker exécute à nouveau la requête, puis effectue le téléchargement.

Pour les dialectes SQL compatibles avec le streaming, l'option Download (Télécharger) de SQL Runner télécharge l'intégralité de l'ensemble de résultats. Pour les dialectes SQL qui ne sont pas compatibles avec le streaming, l'option Télécharger de l'exécuteur SQL ne télécharge que les lignes de la requête affichées dans la section Résultats (jusqu'à 5 000 lignes).

Copier des valeurs de colonne

Vous pouvez copier les valeurs de colonne depuis la section Results (Résultats) de SQL Runner. Sélectionnez le menu Outils d'une colonne pour copier les valeurs dans votre presse-papiers. À partir de là, vous pouvez coller les valeurs des colonnes dans un fichier texte, une feuille de calcul Excel ou un autre emplacement.

Si votre administrateur Looker a activé la fonctionnalité de laboratoire SQL Runner Vis, vous disposez également d'autres options dans le menu en forme de roue dentée de la colonne:

Vous pouvez également déplacer, épingler et resize manuellement les colonnes dans le tableau des résultats.

Estimations de 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 nécessaire à la requête et affiche les informations à proximité du bouton Run (Exécuter).

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

Créer une exploration ad hoc

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

Il existe deux façons d'ouvrir une exploration ad hoc à partir de SQL Runner:

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

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

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

Si votre administrateur Looker a activé la fonctionnalité de laboratoire SQL Runner Vis, vous pouvez créer des visualisations directement dans SQL Runner.

  1. Utilisez SQL Runner pour créer la requête SQL que vous souhaitez utiliser.
  2. Sélectionnez 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 directement cette requête en tant que table dérivée dans votre projet, sélectionnez Add View to Project (Ajouter une vue au projet).

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

Si vous avez accès à la fonctionnalité de champs personnalisés, vous pouvez utiliser les champs personnalisés pour visualiser les champs non modélisés dans SQL Runner. Comme indiqué dans la section précédente, sélectionnez Explorer dans le menu représenté par une roue dentée. Ensuite, dans le sélecteur de champs, procédez comme suit:

Explorer une table répertoriée dans SQL Runner

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

Une fois que vous avez ouvert une exploration pour la table, vous pouvez choisir d'ajouter ou non la table à votre projet. Vous pouvez également utiliser l'onglet SQL de l'exploration pour voir les requêtes SQL que Looker envoie à la base de données, puis utiliser le bouton Ouvrir dans SQL Runner pour réintégrer la requête dans SQL Runner.

  1. Sélectionnez l'onglet Base de données.
  2. Dans SQL Runner, sélectionnez l'engrenage d'une table, puis sélectionnez Explore Table (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 comptabilisation.

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 SQL Runner

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

Mise en surbrillance des erreurs dans l'exécuteur SQL

SQL Runner met en évidence l'emplacement des erreurs dans la commande SQL et inclut 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 des caractères de l'erreur. D'autres dialectes de base de données peuvent avoir 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 un x. Maintenez le pointeur sur x pour afficher plus d'informations sur l'erreur. Après avoir résolu ce problème, sélectionnez Exécuter pour vérifier si la requête comporte d'autres erreurs.

Utiliser SQL Runner pour vérifier les erreurs dans les explorations

Si vous rencontrez des erreurs de syntaxe SQL dans une exploration, vous pouvez utiliser SQL Runner pour déterminer l'emplacement et le type de l'erreur, comme les fautes d'orthographe ou les commandes manquantes.

  1. Dans l'exploration, sélectionnez l'onglet SQL de la barre de données.
  2. Sélectionnez Ouvrir dans SQL Runner pour ouvrir la requête dans SQL Runner.

Cette commande permet de copier le code SQL généré par l'exploration dans SQL Runner. Comme indiqué dans la section Mise en surbrillance des erreurs dans l'exécuteur SQL, SQL Runner met en évidence l'emplacement des erreurs dans la commande SQL et inclut leur position dans le message d'erreur. Vous pouvez ensuite apporter des modifications et réexécuter la requête dans SQL Runner jusqu'à ce que vous ayez corrigé les erreurs.

Utilisation de SQL Runner pour vérifier les erreurs dans les tables dérivées

Pour plus d'informations sur l'utilisation de SQL Runner pour vérifier les erreurs SQL dans les tables dérivées, consultez le post de la communauté Looker Utiliser SQL Runner pour tester les tables dérivées.