> ## 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.

> DBeaver est un outil de base de données multiplateforme.

# Connecter DBeaver à ClickHouse

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Intégration partenaire
        </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>;
};

<PartnerBadge />

DBeaver est disponible en plusieurs éditions. Dans ce guide, [DBeaver Community](https://dbeaver.io/) est utilisé. Consultez les différentes éditions et fonctionnalités [ici](https://dbeaver.com/edition/). DBeaver se connecte à ClickHouse à l’aide de JDBC.

<Note>
  Veuillez utiliser DBeaver version 23.1.0 ou ultérieure pour une meilleure prise en charge des colonnes `Nullable` dans ClickHouse.
</Note>

<Steps>
  <Step title="Rassembler vos informations ClickHouse" id="1-gather-your-clickhouse-details">
    DBeaver utilise JDBC via HTTP(S) pour se connecter à ClickHouse ; vous avez besoin de :

    * endpoint
    * numéro de port
    * nom d’utilisateur
    * mot de passe
  </Step>

  <Step title="Télécharger DBeaver" id="2-download-dbeaver">
    DBeaver est disponible à l’adresse [https://dbeaver.io/download/](https://dbeaver.io/download/)
  </Step>

  <Step title="Ajouter une base de données" id="3-add-a-database">
    * Utilisez soit le menu **Database > New Database Connection**, soit l’icône **New Database Connection** dans le **Database Navigator** pour ouvrir la boîte de dialogue **Connect to a database** :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-add-database.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=6f6924264c39c27a3c16661592163227" size="md" border alt="Ajouter une nouvelle base de données" width="642" height="385" data-path="images/integrations/sql-clients/dbeaver-add-database.webp" />

    * Sélectionnez **Analytical**, puis **ClickHouse** :

    * Construisez l’URL JDBC. Dans l’onglet **Main**, définissez le Host, le Port, le Username, le Password et la Database :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-host-port.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=16ee7f52fde1d693090244aadb65fe95" size="md" border alt="Définir le hostname, le port, l’utilisateur, le mot de passe et le nom de la base de données" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-host-port.webp" />

    * Par défaut, la propriété **SSL > Use SSL** n’est pas activée. Si vous vous connectez à ClickHouse Cloud ou à un server nécessitant SSL sur le port HTTP, activez **SSL > Use SSL** :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-use-ssl.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=c2433e71b3b75b2e2970648c98ddf875" size="md" border alt="Activer SSL si nécessaire" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-use-ssl.webp" />

    * Testez la connexion :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-test-connection.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=bc1487c11c2a6f8abbb8b8623a407039" size="md" border alt="Tester la connexion" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-download-driver.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=d80540e5b6230d2374e3d90c6e645be7" size="md" border alt="Télécharger le pilote ClickHouse" width="612" height="689" data-path="images/integrations/sql-clients/dbeaver-download-driver.webp" />

    * Après avoir téléchargé le pilote, **Test**ez de nouveau la connexion :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-test-connection.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=bc1487c11c2a6f8abbb8b8623a407039" size="md" border alt="Tester la connexion" width="650" height="654" data-path="images/integrations/sql-clients/dbeaver-test-connection.webp" />
  </Step>

  <Step title="Interroger ClickHouse" id="4-query-clickhouse">
    Ouvrez un éditeur de requêtes et exécutez une requête.

    * Faites un clic droit sur votre connexion et choisissez **SQL Editor > Open SQL Script** pour ouvrir un éditeur de requêtes :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-sql-editor.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=f103364c2cf38dc970ec95f09bb1c948" size="md" border alt="Ouvrir l’éditeur SQL" width="636" height="162" data-path="images/integrations/sql-clients/dbeaver-sql-editor.webp" />

    * Exemple de requête sur `system.query_log` :

    <Image img="https://mintcdn.com/private-7c7dfe99/B2SPNiDHMxYV1gTC/images/integrations/sql-clients/dbeaver-query-log-select.webp?fit=max&auto=format&n=B2SPNiDHMxYV1gTC&q=85&s=433e0a24f7bf554e8aea6b8a62a67e50" size="md" border alt="Un exemple de requête" width="712" height="316" data-path="images/integrations/sql-clients/dbeaver-query-log-select.webp" />
  </Step>
</Steps>

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

Consultez le [wiki DBeaver](https://github.com/dbeaver/dbeaver/wiki) pour en savoir plus sur les fonctionnalités de DBeaver, ainsi que la [documentation ClickHouse](/docs/fr/) pour en savoir plus sur les fonctionnalités de ClickHouse.
