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 votre exécuteur SQL, télécharger les résultats, partager des requêtes, les 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 comment utiliser l'exécuteur SQL pour déboguer les requêtes. Consultez ces autres pages de documentation pour en savoir plus:

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 une 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. Assurez-vous donc 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 être transmis à cette fonction.

  1. Saisissez une requête SQL dans la zone de texte située sous la barre Requête.
  2. Vous pouvez également 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. Consultez les résultats dans la zone Results (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 le streaming, vous pouvez télécharger les résultats afin d'afficher l'ensemble des résultats.

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

Après avoir exécuté une requête, vous pouvez 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 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 correspondant à la requête à utiliser dans l'exécuteur SQL:

  1. Dans Explorer, 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 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 dans la zone de texte 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 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'exécuteur SQL Vis est activé, les panneaux d'exécuteur SQL sont réorganisés. Le panneau de visualisation apparaît en haut, le panneau des résultats au milieu et le panneau des requêtes en bas.

  1. Une fois la requête SQL créée et exécutée, 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 SQL Runner 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 sur le fonctionnement des visualisations SQL Runner:

  • 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 le tableau des 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 les champs personnalisés, les calculs de tableaux, les tableaux croisés dynamiques, les totaux des colonnes et les sous-totaux, explorez votre requête d'exécuteur SQL.
  • Les visualisations de cartes statiques (régions) ne sont pas compatibles avec les visualisations SQL Runner, mais sont compatibles avec les cartes qui utilisent les données de latitude et de longitude (visualisations de cartes et de cartes statiques).
  • Les visualisations chronologiques ne sont pas compatibles avec les visualisations SQL Runner.

Rotation de dimensions

Vous pouvez modifier les résultats de la requête pour pivoter selon une ou plusieurs dimensions dans les visualisations SQL Runner. Pour faire pivoter un champ:

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

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

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

Pour annuler le tableau croisé dynamique des résultats, sélectionnez le menu en forme de roue dentée dans la colonne pivotée, puis cliquez sur 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 inversement, procédez comme suit:

  1. Sélectionnez le menu en forme de roue dentée dans la zone Résultats pour afficher les options de colonne.
  2. Sélectionnez Convertir en dimension ou Convertir en mesure pour changer le type de champ.

La visualisation affiche le nouveau type du 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}. Cela peut vous faire gagner du temps lors de la création d'une requête pour résoudre un problème lié à une table dérivée, par exemple.

Looker résout toutes 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 être transmis à cette fonction.

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

  1. Sélectionnez l'onglet Modèle.
  2. Sélectionnez le modèle que vous souhaitez interroger.
  3. Dans la zone de texte sous la barre Données, saisissez votre requête SQL à l'aide des champs LookML.
  4. Vous pouvez également sélectionner une vue dans la liste 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 Prepared SQL Query (Requête SQL préparée), vous pouvez afficher la requête SQL créée après la substitution des valeurs LookML en SQL.
  7. Sélectionnez Exécuter pour exécuter la requête sur votre modèle.
  8. Consultez les résultats dans la zone Results (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 le streaming, vous pouvez télécharger les résultats pour voir l'ensemble des résultats.

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

Lorsque vous avez une requête qui vous plaît, vous pouvez la partager et même l'ajouter à un projet LookML.

Afficher le LookML d'un champ dans l'exécuteur SQL

Dans l'onglet Modèle, vous pouvez également voir le 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 à l'endroit où le champ est défini.

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, sélectionnez l'onglet Historique en haut du volet de navigation. L'exécuteur SQL affiche toutes les requêtes exécutées sur la connexion à la base de données. Le rouge indique qu'une requête n'a pas été exécutée en raison d'une erreur.

Sélectionnez une requête dans l'historique pour l'insérer dans l'exécuteur SQL, puis cliquez sur Exécuter pour réexécuter la requête.

Trier votre requête

L'ordre de tri d'une table 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 colonnes dans l'ordre dans 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 indiquant l'ordre de tri (croissant ou décroissant), et par un 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 des 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 de cet accès. Pour partager une requête, copiez l'URL figurant dans la barre d'adresse de votre navigateur.

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. Écrivez une requête dans la zone 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. Sélectionnez Ouvrir dans le navigateur pour afficher les résultats dans une nouvelle fenêtre, 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 réexécute la requête, puis lance le téléchargement.

Pour les dialectes SQL compatibles avec la diffusion en streaming, l'option Télécharger de l'exécuteur SQL télécharge l'ensemble des 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 qui s'affichent dans la section Results (Résultats) (jusqu'à 5 000 lignes).

Copier des valeurs de colonne

Vous pouvez copier les valeurs des colonnes de la section Résultats dans l'exécuteur SQL. Sélectionnez le menu en forme de roue dentée d'une colonne pour copier les valeurs dans le presse-papiers. Vous pouvez ensuite coller les valeurs de colonnes dans un fichier texte, une feuille de calcul Excel ou un autre emplacement.

Si votre administrateur Looker a activé la fonctionnalité expérimentale Exécuteur SQL, vous disposez également 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.

Estimation du coût des requêtes d'exécuteur SQL

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, l'exécuteur SQL calcule la quantité de données requise par la requête et affiche les informations situées à côté 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 à la base de données Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL pour PostgreSQL et Microsoft Azure PostgreSQL, vous devez activer l'option Cost Estimate (Estimation du coût) pour la connexion. Vous pouvez activer l'estimation des coûts lorsque vous créez la connexion. Pour les connexions existantes, vous pouvez modifier la connexion sur la page Connexions de la section Base de données du panneau Administration de Looker.

Créer une exploration ad hoc

L'exécuteur SQL vous permet d'obtenir rapidement des insights sur les 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 Looker Explore 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 l'exécuteur SQL:

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

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

L'exécuteur SQL 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. Elle peut être utilisée pour n'importe quelle requête, mais elle 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é la fonctionnalité expérimentale 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. Sélectionnez Explorer dans le menu en forme de roue dentée en haut à droite. Vous accédez à une nouvelle exploration, où 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 dans cette exploration pour la partager.
  4. Pour ajouter cette requête en tant que table dérivée directement 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 l'exécuteur SQL

Si vous avez accès à la fonctionnalité Champs personnalisés, vous pouvez les utiliser pour visualiser des champs non modélisés dans SQL Runner. Comme indiqué dans la section précédente, sélectionnez Explorer dans le menu en forme de roue dentée. Ensuite, dans l'outil de sélection de champs, procédez comme suit:

Explorer une table listée dans l'exécuteur SQL

Utilisez l'option Explorer la table dans l'onglet 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 décider de l'ajouter à votre projet. Vous pouvez également consulter l'onglet SQL d'Explore pour afficher les requêtes SQL que Looker envoie à la base de données, puis utiliser le bouton Ouvrir dans l'exécuteur SQL pour réintégrer la requête dans l'exécuteur SQL.

  1. Sélectionnez l'onglet Base de données.
  2. Dans l'exécuteur SQL, sélectionnez la roue dentée d'une table, puis cliquez sur 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 du tableau. (Il en va de même 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 du nombre.

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

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

L'exécuteur SQL est également un outil utile pour vérifier les erreurs SQL dans les requêtes.

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 indique 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 x pour afficher plus d'informations sur l'erreur. Après avoir résolu ce problème, sélectionnez Exécuter pour vérifier que la requête ne comporte pas d'autres erreurs.

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

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

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

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

Vérifier les erreurs dans les tables dérivées à l'aide de l'exécuteur SQL

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.