> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> QStudio est un outil SQL gratuit.

# Connectez QStudio à ClickHouse

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Géré par la communauté
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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.

<div id="1-gather-your-clickhouse-details">
  ## 1. Récupérez vos informations ClickHouse
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="Bouton Connect du service ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="Détails de connexion HTTPS ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<div id="2-download-qstudio">
  ## 2. Télécharger QStudio
</div>

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

<div id="3-add-a-database">
  ## 3. Ajouter une base de données
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/qstudio-add-connection.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=fdd1a841afe95f9a2953062f361dbf94" size="lg" border alt="Écran de configuration de connexion à la base de données dans QStudio affichant les paramètres de connexion ClickHouse" width="701" height="601" data-path="images/integrations/sql-clients/qstudio-add-connection.png" />

1. Type de serveur : Clickhouse.com
2. Notez que, pour l’hôte, vous DEVEZ inclure https\://
   Hôte : [https://abc.def.clickhouse.cloud](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 :

<div id="4-query-clickhouse">
  ## 4. Interroger ClickHouse
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/amY-JDMREAaO7mx6/images/integrations/sql-clients/qstudio-running-query.png?fit=max&auto=format&n=amY-JDMREAaO7mx6&q=85&s=78ebcb051210cd96ad6fed7858d42e1d" size="lg" border alt="Interface de QStudio affichant l’exécution d’une requête SQL d’exemple sur la base de données ClickHouse" width="1283" height="721" data-path="images/integrations/sql-clients/qstudio-running-query.png" />

<div id="next-steps">
  ## Étapes suivantes
</div>

Consultez [QStudio](https://www.timestored.com/qstudio) pour découvrir les fonctionnalités de QStudio, et la [documentation ClickHouse](/fr/) pour en savoir plus sur les fonctionnalités de ClickHouse.