> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

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.

<Steps>
  <Step title="Rassemblez vos informations ClickHouse" id="1-gather-your-clickhouse-details">
    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** :

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="Bouton Connect du service ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="Détails de connexion HTTPS ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="Téléchargez QStudio" id="2-download-qstudio">
    QStudio est disponible à l’adresse [https://www.timestored.com/qstudio/download/](https://www.timestored.com/qstudio/download/)
  </Step>

  <Step title="Ajouter une base de données" id="3-add-a-database">
    * 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 :

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

    1. Server Type: Clickhouse.com
    2. Remarque : pour Host, vous DEVEZ inclure https\://
       Host: [https://abc.def.clickhouse.cloud](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 :
  </Step>

  <Step title="Interroger ClickHouse" id="4-query-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 :

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

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

Consultez [QStudio](https://www.timestored.com/qstudio) pour découvrir les fonctionnalités de QStudio, ainsi que la [documentation ClickHouse](/docs/fr/) pour découvrir les fonctionnalités de ClickHouse.