La console SQL est le moyen le plus rapide et le plus simple d’explorer vos bases de données et d’exécuter des requêtes dans ClickHouse Cloud. Vous pouvez utiliser la console SQL pour :
- Vous connecter à vos services ClickHouse Cloud
- Afficher, filtrer et trier les données des tables
- Exécuter des requêtes et visualiser les résultats en quelques clics seulement
- Partager des requêtes avec les membres de l’équipe et collaborer plus efficacement.
Un aperçu des tables contenues dans votre instance ClickHouse est disponible dans la barre latérale de gauche. Utilisez le sélecteur de base de données en haut de la barre latérale gauche pour afficher les tables d’une base de données spécifique
Les tables de la liste peuvent également être développées pour afficher les colonnes et les types
Explorer les données d’une table
Inspection des données d’une cellule
Filtrage et tri des tables
Les tris sont appliqués dans l’ordre dans lequel ils apparaissent dans le panneau de tri (de haut en bas). Pour supprimer un tri, cliquez simplement sur le bouton ‘x’ à côté du tri.
Filtrer et trier simultanément
Créer une requête à partir de filtres et de tris
Les filtres et les tris ne sont pas requis pour utiliser la fonctionnalité ‘Create Query’.
Créer et exécuter une requête
- Cliquez sur le bouton ’+’ dans la barre d’onglets
- Sélectionnez le bouton ‘Nouvelle requête’ dans la liste des requêtes du volet latéral gauche
Pour exécuter une requête, saisissez votre ou vos commandes SQL dans le SQL Editor, puis cliquez sur le bouton ‘Run’ ou utilisez le raccourci cmd / ctrl + enter. Pour écrire et exécuter plusieurs commandes à la suite, veillez à ajouter un point-virgule après chaque commande.
Options d’exécution des requêtes
Par défaut, un clic sur le bouton ‘Run’ exécute toutes les commandes contenues dans le SQL Editor. La console SQL prend en charge deux autres options d’exécution des requêtes :
- Exécuter les commandes sélectionnées
- Exécuter la commande au niveau du curseur
Pour exécuter les commandes sélectionnées, sélectionnez la commande ou la séquence de commandes souhaitée, puis cliquez sur le bouton ‘Run’ (ou utilisez le raccourci cmd / ctrl + enter). Vous pouvez également sélectionner ‘Run selected’ dans le menu contextuel du SQL Editor (ouvert par un clic droit n’importe où dans l’éditeur) lorsqu’un texte est sélectionné.
La commande à la position actuelle du curseur peut être exécutée de deux manières :
- Sélectionnez ‘At Cursor’ dans le menu étendu des options d’exécution (ou utilisez le raccourci clavier correspondant
cmd / ctrl + shift + enter
- Sélectionnez ‘Run at cursor’ dans le menu contextuel du SQL Editor
La commande à la position du curseur clignote en jaune lors de son exécution.
Esc pour annuler la requête. Remarque : tous les résultats déjà renvoyés seront conservés après l’annulation.
L’enregistrement des requêtes vous permet de les retrouver facilement par la suite et de les partager avec vos collègues. La console SQL vous permet également d’organiser vos requêtes dans des dossiers.
Pour enregistrer une requête, cliquez simplement sur le bouton “Save” juste à côté du bouton “Run” dans la barre d’outils. Saisissez le nom souhaité, puis cliquez sur “Save Query”.
Le raccourci cmd / ctrl + s permet également d’enregistrer tout le travail en cours dans l’onglet de requête actuel.
- Owner (peut modifier les options de partage)
- Accès en écriture
- Accès en lecture seule
- Aucun accès
Après avoir enregistré une requête, cliquez sur le bouton “Share” dans la barre d’outils. Une fenêtre modale proposant des options de partage s’affiche :
Pour ajuster l’accès aux requêtes pour tous les membres de l’organisation ayant accès au service, modifiez simplement le sélecteur de niveau d’accès sur la ligne supérieure :
Une fois cette opération effectuée, la requête peut être consultée (et exécutée) par tous les membres de l’équipe ayant accès à la console SQL du service.
Pour ajuster l’accès aux requêtes pour certains membres en particulier, sélectionnez le membre de l’équipe souhaité dans le sélecteur “Add a team member” :
Après avoir sélectionné un membre de l’équipe, une nouvelle ligne doit apparaître avec un sélecteur de niveau d’accès :
Accéder aux requêtes partagées
Lien vers une requête (liens permanents)
{start_date: Date} et {end_date: Date}, le lien permanent peut ressembler à : https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01¶m_end_date=2016-01-01.
Fonctionnalités avancées pour les requêtes
Recherche dans les résultats d’une requête
WHERE supplémentaire ou simplement de vérifier que certaines données sont bien incluses dans le jeu de résultats. Après avoir saisi une valeur dans le champ de recherche, le volet des résultats se met à jour et renvoie les enregistrements contenant une entrée correspondant à la valeur saisie. Dans cet exemple, nous allons rechercher toutes les occurrences de breakfast dans la table hackernews pour les commentaires contenant ClickHouse (sans tenir compte de la casse) :
Remarque : tout champ correspondant à la valeur saisie sera renvoyé. Par exemple, le troisième enregistrement de la capture d’écran ci-dessus ne correspond pas à « breakfast » dans le champ by, mais le champ text, lui, correspond :
Par défaut, le volet des résultats de la requête affiche tous les enregistrements sur une seule page. Pour les jeux de résultats plus volumineux, il peut être préférable de paginer les résultats afin d’en faciliter la consultation. Pour cela, utilisez le sélecteur de pagination situé dans l’angle inférieur droit du volet des résultats :
La sélection d’une taille de page applique immédiatement la pagination au jeu de résultats, et des options de navigation apparaissent alors au centre du pied de page du volet des résultats.
Exporter les données des résultats de requête
••• à droite de la barre d’outils du volet des résultats, puis sélectionnez ‘Télécharger au format CSV’.
Visualiser les données de requête
SELECT
toStartOfWeek(pickup_datetime) AS week,
sum(total_amount) AS fare_total,
sum(trip_distance) AS distance_total,
count(*) AS trip_total
FROM
nyc_taxi
GROUP BY
1
ORDER BY
1 ASC
trip_total par week. Pour cela, faites glisser le champ week sur l’axe des x et le champ trip_total sur l’axe des y :
La plupart des types de graphiques prennent en charge plusieurs champs sur les axes numériques. Pour l’illustrer, faites glisser le champ fare_total sur l’axe des y :
Personnaliser les graphiques
- Sous-titre
- Titres des axes
- Orientation des libellés de l’axe des x
Le graphique sera mis à jour en conséquence :
Dans certains cas, il peut être nécessaire d’ajuster indépendamment l’échelle des axes pour chaque champ. Pour cela, utilisez la section ‘Advanced’ du volet de configuration du graphique et définissez les valeurs minimale et maximale de la plage d’un axe. Par exemple, le graphique ci-dessus est correct, mais pour mieux montrer la corrélation entre nos champs trip_total et fare_total, les plages des axes doivent être ajustées :
