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

> Databrain est une plateforme d’analytique embarquée qui s’intègre parfaitement à ClickHouse pour créer des tableaux de bord destinés aux clients, des métriques et des visualisations de données.

# Connecter Databrain à 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>;
};

[Databrain](https://usedatabrain.com) est une plateforme d’analytique embarquée qui vous permet de créer et de partager des tableaux de bord interactifs, des métriques et des visualisations de données avec vos clients. Databrain se connecte à ClickHouse via l’interface HTTPS, ce qui facilite la visualisation et l’analyse de vos données ClickHouse dans une interface moderne et conviviale.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_01.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=fbd9fa67d77d18f8a224b237e7c8ddaa" alt="Interface de tableau de bord Databrain affichant une visualisation de données ClickHouse" border width="3408" height="1820" data-path="images/integrations/data-visualization/databrain_01.webp" />

<br />

Ce guide vous explique comment connecter Databrain à votre instance ClickHouse.

<div id="pre-requisites">
  ## Prérequis
</div>

* Une base de données ClickHouse hébergée soit sur votre propre infrastructure, soit sur [ClickHouse Cloud](https://clickhouse.com/).
* Un [compte Databrain](https://app.usedatabrain.com/users/sign-up).
* Un espace de travail Databrain pour connecter votre source de données.

<div id="steps-to-connect-databrain-to-clickhouse">
  ## Étapes pour connecter Databrain à ClickHouse
</div>

<div id="1-gather-your-connection-details">
  ### 1. Rassemblez vos informations de connexion
</div>

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-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="Bouton Connect du service ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="Détails de connexion HTTPS ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

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

<div id="2-allow-databrain-ip-addresses">
  ### 2. Autoriser les adresses IP de Databrain (si nécessaire)
</div>

Si le filtrage IP est activé sur votre instance ClickHouse, vous devrez ajouter les adresses IP de Databrain à la liste d’autorisation.

Pour les utilisateurs de ClickHouse Cloud :

1. Accédez à votre service dans la console ClickHouse Cloud
2. Ouvrez **Settings** → **Security**
3. Ajoutez les adresses IP de Databrain à la liste d’autorisation

<Tip>
  Consultez la [documentation de Databrain sur l’autorisation des adresses IP](https://docs.usedatabrain.com/guides/datasources/allow-access-to-our-ip) pour obtenir la liste à jour des adresses IP à autoriser.
</Tip>

<div id="3-add-clickhouse-as-a-data-source">
  ### 3. Ajouter ClickHouse comme source de données dans Databrain
</div>

1. Connectez-vous à votre compte Databrain et accédez à l’espace de travail dans lequel vous souhaitez ajouter la source de données.

2. Cliquez sur **Data Sources** dans le menu de navigation.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_02.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=bc07a26ef4c913c70e2224543c010fde" alt="Menu Data Sources de Databrain" border width="3420" height="1830" data-path="images/integrations/data-visualization/databrain_02.webp" />

3. Cliquez sur **Add a Data Source** ou **Connect Data Source**.

4. Sélectionnez **ClickHouse** dans la liste des connecteurs disponibles.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_03.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=36f67acbc3a08c6af32258b0e5678db2" alt="Sélection du connecteur Databrain affichant l’option ClickHouse" border width="1920" height="917" data-path="images/integrations/data-visualization/databrain_03.webp" />

5. Renseignez les informations de connexion :
   * **Destination Name** : saisissez un nom descriptif pour cette connexion (par ex., "Production ClickHouse" ou "Analytics DB")
   * **Host** : saisissez l’URL de votre hôte ClickHouse (par ex., `https://your-instance.region.aws.clickhouse.cloud`)
   * **Port** : saisissez `8443` (port HTTPS par défaut pour ClickHouse)
   * **Username** : saisissez votre nom d’utilisateur ClickHouse
   * **Password** : saisissez votre mot de passe ClickHouse

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_04.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=8de8629878fec2d481b2530eb4d67ba9" alt="Formulaire de connexion ClickHouse de Databrain avec champs de configuration" border width="1917" height="914" data-path="images/integrations/data-visualization/databrain_04.webp" />

6. Cliquez sur **Test Connection** pour vérifier que Databrain peut se connecter à votre instance ClickHouse.

7. Une fois la connexion établie avec succès, cliquez sur **Save** ou **Connect** pour ajouter la source de données.

<div id="4-configure-user-permissions">
  ### 4. Configurer les autorisations de l’utilisateur
</div>

Assurez-vous que l’utilisateur ClickHouse avec lequel vous vous connectez dispose des autorisations nécessaires :

```sql theme={null}
-- Grant permissions to read schema information
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- Grant read access to your database and tables
GRANT SELECT ON your_database.* TO your_databrain_user;
```

Remplacez `your_databrain_user` et `your_database` par votre nom d’utilisateur réel et le nom de votre base de données.

<div id="using-databrain-with-clickhouse">
  ## Utilisation de Databrain avec ClickHouse
</div>

<div id="explore-your-data">
  ### Explorez vos données
</div>

1. Une fois la connexion établie, accédez à votre espace de travail dans Databrain.

2. Vos tables ClickHouse apparaissent dans l’explorateur de données.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_05.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1f160f054eb7b97b7bfe32f5c02283e6" alt="Explorateur de données Databrain affichant des tables ClickHouse" border width="1919" height="920" data-path="images/integrations/data-visualization/databrain_05.webp" />

3. Cliquez sur une table pour en explorer le schéma et prévisualiser les données.

<div id="create-metrics-and-visualizations">
  ### Créer des métriques et des visualisations
</div>

1. Cliquez sur **Create Metric** pour créer des visualisations à partir de vos données ClickHouse.

2. Sélectionnez votre source de données ClickHouse et choisissez la table que vous souhaitez visualiser.

3. Utilisez l'interface intuitive de Databrain pour :
   * Sélectionner des dimensions et des mesures
   * Appliquer des filtres et des agrégations
   * Choisir des types de visualisation (histogrammes, graphiques linéaires, graphiques en secteurs, tables, etc.)
   * Ajouter des requêtes SQL personnalisées pour des analyses avancées

4. Enregistrez votre métrique pour la réutiliser dans plusieurs tableaux de bord.

<div id="build-dashboards">
  ### Créer des tableaux de bord
</div>

1. Cliquez sur **Create Dashboard** pour commencer à créer un tableau de bord.

2. Ajoutez des métriques à votre tableau de bord par glisser-déposer à partir des métriques enregistrées.

3. Personnalisez la disposition et l'apparence de votre tableau de bord.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_06.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=c215e38acb4d6e9edaa988338d268969" alt="Tableau de bord Databrain avec plusieurs visualisations ClickHouse" border width="1918" height="888" data-path="images/integrations/data-visualization/databrain_06.webp" />

4. Partagez votre tableau de bord avec votre équipe ou intégrez-le à votre application.

<div id="advanced-features">
  ### Fonctionnalités avancées
</div>

Databrain offre plusieurs fonctionnalités avancées pour travailler avec ClickHouse :

* **Console SQL personnalisée** : rédigez et exécutez des requêtes SQL personnalisées directement sur votre base de données ClickHouse
* **Multi-tenant et single-tenant** : connectez votre base de données ClickHouse, avec des architectures single-tenant et multi-tenant
* **Planification des rapports** : planifiez des rapports automatisés et envoyez-les par e-mail aux parties prenantes
* **Insights alimentés par l’IA** : utilisez l’IA pour générer des résumés et des insights à partir de vos données
* **Embedded Analytics** : intégrez des tableaux de bord et des métriques directement dans vos applications
* **Couche sémantique** : créez des modèles de données réutilisables et de la logique métier

<div id="troubleshooting">
  ## Dépannage
</div>

<div id="connection-fails">
  ### La connexion échoue
</div>

Si vous ne parvenez pas à vous connecter à ClickHouse :

1. **Vérifiez les identifiants** : revérifiez votre nom d'utilisateur, votre mot de passe et l'URL de l'hôte
2. **Vérifiez le port** : assurez-vous d'utiliser le port `8443` pour HTTPS (ou `8123` pour HTTP si vous n'utilisez pas SSL)
3. **Autorisation des adresses IP** : confirmez que les adresses IP de Databrain sont autorisées dans les paramètres de pare-feu/sécurité de ClickHouse
4. **SSL/TLS** : assurez-vous que SSL/TLS est correctement configuré si vous utilisez HTTPS
5. **Autorisation de l'utilisateur** : vérifiez que l'utilisateur dispose des droits SELECT sur `information_schema` et vos bases de données cibles

<div id="slow-query-performance">
  ### Lenteur des requêtes
</div>

Si les requêtes s'exécutent lentement :

1. **Optimisez vos requêtes** : utilisez efficacement les filtres et les agrégations
2. **Créez des vues matérialisées** : pour les agrégations fréquemment consultées, envisagez de créer des vues matérialisées dans ClickHouse
3. **Utilisez des types de données appropriés** : assurez-vous que votre schéma ClickHouse utilise des types de données optimaux
4. **Optimisez les index** : exploitez les clés primaires et les index de saut de ClickHouse

<div id="learn-more">
  ## En savoir plus
</div>

Pour en savoir plus sur les fonctionnalités de Databrain et sur la création d'analyses avancées :

* [Documentation Databrain](https://docs.usedatabrain.com/)
* [Guide d’intégration ClickHouse](https://docs.usedatabrain.com/guides/datasources/connecting-data-sources-to-databrain/clickhouse)
* [Créer des tableaux de bord](https://docs.usedatabrain.com/guides/dashboards/create-a-dashboard)
* [Créer des métriques](https://docs.usedatabrain.com/guides/metrics/create-metrics)