Connectez QStudio à ClickHouse

QStudio est un outil SQL gratuit.

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.

​

1. Récupérez vos informations ClickHouse

QStudio utilise JDBC sur HTTP(S) pour se connecter à ClickHouse ; vous avez besoin des éléments suivants :

• 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 :

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

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

​

2. Télécharger QStudio

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

​

3. 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.
• Renseignez ensuite les informations suivantes :

1. Type de serveur : Clickhouse.com
2. Notez que, pour l’hôte, vous DEVEZ inclure https:// Hôte : https://abc.def.clickhouse.cloud Port : 8443
3. Nom d’utilisateur : default Mot de passe : XXXXXXXXXXX
4. Cliquez sur Add

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

​

4. Interroger ClickHouse

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

• Ctrl + e - Exécute le texte sélectionné

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

• Exemple de requête :

​

Étapes suivantes

Consultez QStudio pour découvrir les fonctionnalités de QStudio, et la documentation ClickHouse pour en savoir plus sur les fonctionnalités de ClickHouse.