Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Connectez QStudio à ClickHouse

Géré par la communauté

QStudio est une interface graphique SQL gratuite qui permet d’exécuter des scripts SQL, de parcourir facilement les tables, de créer des graphiques et d’exporter les résultats. Il fonctionne sur tous les systèmes d’exploitation et avec toutes les bases de données.

QStudio se connecte à ClickHouse via JDBC.

Rassemblez vos informations ClickHouse

QStudio utilise JDBC sur HTTP(S) pour se connecter à ClickHouse ; vous avez besoin de :

  • endpoint
  • numéro de port
  • nom d’utilisateur
  • mot de passe

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :

Paramètre(s) Description
HOST and PORT En général, le port est 8443 lors de l’utilisation de TLS, ou 8123 sans TLS.
DATABASE NAME Par défaut, une base de données nommée default est disponible ; utilisez le nom de la base de données à laquelle vous voulez vous connecter.
USERNAME and PASSWORD Par défaut, le nom d’utilisateur est default. Utilisez le nom d’utilisateur adapté à votre cas d’usage.

Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez un service, puis cliquez sur Connect :

Bouton Connect du service ClickHouse Cloud

Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.

Détails de connexion HTTPS ClickHouse Cloud

Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

Téléchargez QStudio

QStudio est disponible à l’adresse https://www.timestored.com/qstudio/download/

Ajouter une base de données

  • Lorsque vous ouvrez QStudio pour la première fois, cliquez sur les options du menu Server->Add Server ou sur le bouton d’ajout de serveur dans la barre d’outils.
  • Ensuite, renseignez les informations :
Écran de configuration de connexion à la base de données QStudio affichant les paramètres de connexion à ClickHouse
  1. Server Type: ClickHouse.com
  2. Remarque : pour Host, vous DEVEZ inclure https:// Host: https://abc.def.clickhouse.cloud Port: 8443
  3. Username: default Password: XXXXXXXXXXX
  4. Cliquez sur Add

Si QStudio détecte que vous n’avez pas installé le ClickHouse JDBC driver, il vous proposera de le télécharger pour vous :

Interroger ClickHouse

  • Ouvrez un éditeur de requêtes et exécutez une requête. Vous pouvez exécuter des requêtes avec :

  • Ctrl + e - Exécute le texte surligné

  • Ctrl + Enter - Exécute la ligne en cours

  • Exemple de requête :

Interface QStudio montrant l’exécution d’une requête SQL d’exemple sur une base de données ClickHouse

Étapes suivantes

Consultez QStudio pour découvrir les fonctionnalités de QStudio, ainsi que la documentation ClickHouse pour découvrir les fonctionnalités de ClickHouse.

Navigation