SQL Runner vous permet d'accéder directement à votre base de données et de l'utiliser de différentes manières. Avec SQL Runner, vous pouvez 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 des résultats, partager des requêtes, ajouter des tables dérivées à un projet LookML et effectuer d'autres tâches utiles.
Cette page explique comment modifier le schéma et les données de votre base de données à l'aide de SQL Runner, afficher le plan d'exécution de votre base de données pour une requête avec l'instruction EXAMINE et utiliser SQL Runner pour obtenir des informations sur votre base de données. Consultez les autres pages de documentation pour en savoir plus sur:
- Principes de base de SQL Runner
- Utiliser SQL Runner pour créer des requêtes et des explorations
- Utiliser SQL Runner pour créer des tables dérivées
Modifier le schéma et les données de la base de données
En plus d'exécuter des requêtes sur votre base de données, l'onglet Database (Base de données) de SQL Runner vous permet d'exécuter des instructions en langage de définition de données (LDD) et en langage de manipulation de données (LMD) sur votre base de données. Vous pouvez utiliser SQL Runner pour apporter des modifications au schéma (création, suppression et modification, par exemple) et aux données (insertion, mise à jour et suppression, par exemple). Les dialectes SQL sont compatibles avec des instructions LDD et LMD différentes. Consultez la documentation de votre base de données pour connaître les instructions compatibles.
Pour exécuter une instruction LDD ou DML sur votre base de données dans SQL Runner, procédez comme suit:
- Accédez à SQL Runner.
- Dans SQL Runner, cliquez sur l'onglet Database (Base de données).
- Saisissez l'instruction LDD ou DML dans la zone Requête de l'exécuteur SQL. (Consultez la documentation de votre dialecte de base de données pour connaître la compatibilité et la syntaxe des instructions LDD et LMD.)
- Cliquez sur Run (Exécuter) pour exécuter l'instruction dans votre base de données.
Si l'instruction est exécutée correctement sur votre base de données, la boîte de dialogue Résultats SQL affiche une confirmation.
Examiner un plan d'exécution à l'aide de EXPLAIN
En plus d'exécuter des requêtes SQL sur votre base de données, vous pouvez utiliser SQL Runner pour exécuter une fonction EXPLAIN pour une requête. La fonction EXPLAIN, compatible avec la plupart des dialectes SQL, renvoie le plan d'exécution de la base de données pour une requête.
- Dans une exploration, exécutez une requête, puis cliquez sur l'onglet SQL de la zone Données pour afficher la commande SQL de la requête.
Dans l'onglet SQL de l'exploration, cliquez sur le bouton Expliquer dans l'exécuteur SQL.
Looker ouvre SQL Runner et charge la requête dans une fonction
EXPLAIN.Dans SQL Runner, cliquez sur Run (Exécuter) pour exécuter la fonction
EXPLAIN.Consultez le résultat de la fonction
EXPLAIN.
Les informations et le format exacts de la réponse EXPLAIN dépendent de votre dialecte spécifique. Pour en savoir plus, consultez la documentation de votre dialecte.
Dans l'exemple MySQL précédent, la fonction EXPLAIN renvoie la liste des étapes suivies par la base de données pour effectuer la requête. Cela peut être utile pour les requêtes qui semblent lentes à exécuter, car vous constaterez peut-être que votre base de données analyse une table entière dans une requête, alors que la table pourrait utiliser un indice pour améliorer les performances.
Pour obtenir un exemple détaillé de l'utilisation de EXPLAIN dans SQL Runner pour optimiser SQL, consultez l'article de la communauté Comment optimiser SQL avec EXPLAIN
.
Obtenir des informations sur votre base de données
L'onglet Database (Base de données) de SQL Runner contient de nombreux outils qui vous permettent d'obtenir des informations sur votre base de données.
Obtenir des informations sur la connexion à la base de données
Lorsque vous choisissez une connexion dans SQL Runner, Looker affiche le dialecte de base de données de cette connexion à droite de la bannière REQUÊTE SQL. Si vous avez accédé à SQL Runner en sélectionnant Ouvrir dans SQL Runner ou Expliquer dans SQL Runner, Looker présélectionne la connexion appropriée et affiche le dialecte de base de données de la connexion.
Cliquez sur le menu en forme de roue dentée de la connexion pour obtenir plus d'options pour la connexion à la base de données:
- Sélectionnez l'option Afficher les processus pour afficher des informations sur les requêtes et les processus en cours d'exécution sur la connexion.
- Sélectionnez l'option Actualiser les schémas et les tables pour réimporter les schémas et les tables de la base de données dans le volet de navigation de gauche de SQL Runner.
Options du menu en forme de roue dentée de BigQuery
Lorsque vous choisissez une connexion BigQuery compatible avec plusieurs bases de données, Looker affiche des options spécifiques au dialecte dans le menu en forme de roue dentée. L'élément de menu bascule entre Afficher les projets disponibles et Rechercher des projets publics, en fonction de l'option sélectionnée.
- Sélectionnez Actualiser les schémas et les tables pour réimporter les schémas et les tables de la base de données dans le volet de navigation de gauche de SQL Runner.
- Lorsque les projets disponibles s'affichent, une option du menu en forme de roue dentée permet de rechercher des projets publics. Sélectionnez cette option pour rechercher des ensembles de données publics qui ne sont pas visibles dans le schéma d'informations.
- Lorsque les projets publics s'affichent, une option du menu en forme de roue dentée permet d'afficher les projets disponibles. Sélectionnez cette option pour afficher à nouveau les projets et les tables BigQuery spécifiques à la connexion dans le volet de navigation de gauche de SQL Runner.
Rechercher dans votre base de données
SQL Runner affiche une zone de recherche sous le schéma sélectionné (ou Ensemble de données, pour les connexions Google BigQuery).
La recherche SQL Runner parcourt les noms de toutes les tables et colonnes de table contenant la chaîne dans le champ de recherche. Dans l'image suivante, "airport_name" est une colonne et "airport_remarks" est une table.
Cliquez sur l'un des résultats de recherche pour accéder à cet élément dans SQL Runner.
Obtenir des informations sur la table
Par défaut, SQL Runner précharge toutes les informations de la table lorsque vous sélectionnez une connexion et un schéma. Pour les connexions comportant de nombreuses tables ou des tables très volumineuses, un administrateur peut désactiver ce comportement en désélectionnant l'option SQL Runner Precache (Préchargement de SQL Runner) sur la page Connexions.
Le panneau de navigation de gauche de SQL Runner vous permet de parcourir les schémas et les tables de vos connexions. Sélectionnez une connexion et un schéma pour afficher toutes les tables de ce schéma. Cliquez sur le nom d'une table pour afficher les champs de cette table.
SQL Runner propose des requêtes préécrites pour vous aider à comprendre vos données. Pour utiliser ces requêtes, cliquez sur la roue dentée qui s'affiche à côté du nom d'un tableau ou d'une colonne de tableau, puis sélectionnez la requête que vous souhaitez exécuter. Looker génère automatiquement le code SQL dans la section Requête SQL, et la requête est exécutée.
Les requêtes disponibles varient selon le dialecte de la base de données.
Informations sur la table
Looker affiche les options suivantes lorsque vous cliquez sur la roue dentée à côté du nom d'un tableau:
- Explorer le tableau: ouvre un nouvel onglet de navigateur pour afficher une exploration Looker du tableau.
- Décrire: affiche les noms des colonnes du tableau sous-jacent, ainsi que leurs types de données.
- Afficher les index: affiche des informations sur l'indexation de la table.
- Sélectionner 10: renvoie une requête sur les dix premières lignes du tableau. C'est un bon moyen de se faire une idée de ce à quoi ressemblent réellement les données.
- Count (Nombre) : renvoie une requête
count(*)simple pour obtenir le nombre total de lignes de la table.
Informations sur les colonnes
Cliquez sur le nom d'une table pour afficher ses colonnes. Lorsque vous cliquez sur la roue dentée à côté du nom d'une colonne, Looker affiche les options suivantes:
- Valeurs les plus courantes: renvoie une requête des valeurs les plus courantes pour cette colonne de tableau, ainsi qu'un nombre indiquant combien de fois cette valeur apparaît dans la colonne.
- Nombre approximatif de valeurs distinctes: affiche un nombre approximatif de valeurs distinctes trouvées dans la colonne.
Obtenir des informations sur le type de données des colonnes
Pour obtenir des informations sur le type de données des colonnes à l'aide de SQL Runner, procédez comme suit:
- Dans SQL Runner, sélectionnez la connexion à la base de données dans le menu déroulant Connexion.
- Sélectionnez le schéma dans la liste déroulante Schéma. (Pour les connexions BigQuery, sélectionnez Project (Projet) et Dataset (Ensemble de données).)
- SQL Runner affiche la liste des tables de ce schéma dans votre base de données. Cliquez sur un tableau pour afficher ses colonnes.
- Chaque nom de colonne est associé à une icône représentant le type de données. Pointez sur un nom de colonne pour afficher le type de données correspondant.
Modifier les requêtes SQL prédéfinies
Vous pouvez modifier n'importe quelle requête SQL dans la zone Requête, y compris les requêtes SQL prédéfinies choisies dans les menus en forme de roue dentée de la table et du champ.
Par exemple, vous pouvez utiliser la requête Count (Compter) de SQL Runner pour charger une commande de comptage de base pour une base de données, puis modifier la requête SQL. Si vous pensez que la colonne id de la table public.users peut être une clé primaire, vous pouvez vérifier qu'il n'y a pas de valeurs en double en modifiant la requête de comptage comme suit:
SELECT id ,COUNT(*)
FROM public.users
GROUP BY 1
ORDER BY 2 DESC
LIMIT 10
Étant donné que la requête est triée par nombre avant que les résultats ne soient limités à 10 lignes, les résultats incluront les valeurs de nombre les plus élevées. Si cette requête renvoie un nombre de 1 pour chaque valeur id, id est probablement la clé primaire de ce tableau. Toutefois, cette requête ne spécifie que les lignes de la table au moment de l'exécution de la requête. Étant donné que de futures insertions dans la base de données peuvent disqualifier id en tant que clé primaire, nous vous recommandons d'implémenter des restrictions dans votre base de données pour vous assurer que vos clés primaires sont uniques.