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

> Importez facilement les données de votre base de données MySQL ou MariaDB vers ClickHouse Cloud.

# Ingestion des données de MySQL vers ClickHouse (avec CDC)

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

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Fonctionnalité en bêta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        En savoir plus.
                    </a>
                </u>
            </span>
        </div>;
};

<Info>
  L’ingestion de données de MySQL vers ClickHouse Cloud via ClickPipes est en bêta publique.
</Info>

Le MySQL ClickPipe offre une solution entièrement gérée et résiliente pour ingérer des données à partir de bases de données MySQL et MariaDB vers ClickHouse Cloud. Il prend en charge aussi bien les **chargements en masse** pour une ingestion ponctuelle que la **Change Data Capture (CDC)** pour l’ingestion continue.

Les MySQL ClickPipes peuvent être déployés et gérés manuellement à l’aide de la ClickPipes UI, ainsi que par programmation à l’aide d’[OpenAPI](/fr/integrations/clickpipes/programmatic-access/openapi) et de [Terraform](/fr/integrations/clickpipes/programmatic-access/terraform).

<div id="prerequisites">
  ## Prérequis
</div>

[//]: # "TODO La configuration de la réplication du binlog n’est pas nécessaire pour les pipes d’ingestion ponctuelle. Cela a déjà prêté à confusion par le passé ; nous devrions donc également indiquer les exigences minimales pour les chargements en masse afin d’éviter de rebuter les utilisateurs."

Pour commencer, vous devez vous assurer que votre base de données MySQL est correctement configurée pour la réplication du binlog. Les étapes de configuration dépendent du mode de déploiement de MySQL ; veuillez donc suivre le guide approprié ci-dessous :

<div id="supported-data-sources">
  ### Sources de données prises en charge
</div>

| Nom                                                              | Logo | Détails                                                                                                                                   |
| ---------------------------------------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Amazon RDS MySQL** <br /> *Chargement ponctuel, CDC*           |      | Suivez le guide de configuration [Amazon RDS MySQL](/fr/integrations/clickpipes/mysql/source/rds).                                        |
| **Amazon Aurora MySQL** <br /> *Chargement ponctuel, CDC*        |      | Suivez le guide de configuration [Amazon Aurora MySQL](/fr/integrations/clickpipes/mysql/source/aurora).                                  |
| **Cloud SQL for MySQL** <br /> *Chargement ponctuel, CDC*        |      | Suivez le guide de configuration [Cloud SQL for MySQL](/fr/integrations/clickpipes/mysql/source/gcp).                                     |
| **Azure Flexible Server for MySQL** <br /> *Chargement ponctuel* |      | Suivez le guide de configuration [Azure Flexible Server for MySQL](/fr/integrations/clickpipes/mysql/source/azure-flexible-server-mysql). |
| **MySQL auto-hébergé** <br /> *Chargement ponctuel, CDC*         |      | Suivez le guide de configuration [Generic MySQL](/fr/integrations/clickpipes/mysql/source/generic).                                       |
| **Amazon RDS MariaDB** <br /> *Chargement ponctuel, CDC*         |      | Suivez le guide de configuration [Amazon RDS MariaDB](/fr/integrations/clickpipes/mysql/source/rds-maria).                                |
| **MariaDB auto-hébergé** <br /> *Chargement ponctuel, CDC*       |      | Suivez le guide de configuration [Generic MariaDB](/fr/integrations/clickpipes/mysql/source/generic-maria).                               |

Une fois votre base de données MySQL source configurée, vous pouvez continuer à créer votre ClickPipe.

<div id="create-your-clickpipe">
  ## Créez votre ClickPipe
</div>

Assurez-vous d’être connecté à votre compte ClickHouse Cloud. Si vous n’avez pas encore de compte, vous pouvez vous inscrire [ici](https://cloud.clickhouse.com/).

[//]: # "   TODO mettre à jour l’image ici"

1. Dans la console ClickHouse Cloud, accédez à votre service ClickHouse Cloud.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_service.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=02ff8f342ae5f1bed228fb111e05c78b" alt="Service ClickPipes" size="lg" border width="1184" height="482" data-path="images/integrations/data-ingestion/clickpipes/cp_service.png" />

2. Sélectionnez le bouton `Data Sources` dans le menu de gauche, puis cliquez sur « Set up a ClickPipe »

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=3a59ce71568eecec94d17e9947e9d2ea" alt="Sélectionner les importations" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />

3. Sélectionnez la tuile `MySQL CDC`

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=9543b10e0634127b79046baa721e5e59" alt="Sélectionner MySQL" size="lg" border width="2612" height="892" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.png" />

<div id="add-your-source-mysql-database-connection">
  ### Ajoutez la connexion à votre base de données source MySQL
</div>

4. Renseignez les informations de connexion de votre base de données source MySQL, que vous avez configurée lors de l’étape des prérequis.

<Info>
  Avant de commencer à saisir vos informations de connexion, assurez-vous d’avoir autorisé les adresses IP de ClickPipes dans les règles de votre pare-feu. Sur la page suivante, vous trouverez une [liste des adresses IP de ClickPipes](/fr/integrations/clickpipes/home#list-of-static-ips).
  Pour plus d’informations, consultez les guides de configuration de la base MySQL source liés [en haut de cette page](#prerequisites).
</Info>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=e5c11240befd2c626bd915c9f8775253" alt="Renseignez les informations de connexion" size="lg" border width="1842" height="1556" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png" />

<div id="optional-set-up-ssh-tunneling">
  #### (Facultatif) Configurer le tunnel SSH
</div>

Vous pouvez préciser les informations du tunnel SSH si votre base de données source MySQL n’est pas accessible publiquement.

1. Activez le bouton bascule « Use SSH Tunnelling ».

2. Renseignez les informations de connexion SSH.

   <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/kkh98eOd_iRyUp1R/images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg?fit=max&auto=format&n=kkh98eOd_iRyUp1R&q=85&s=2ef2f529ab68bfc828b40043e5dc164d" alt="Tunnel SSH" size="lg" border width="1780" height="1342" data-path="images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg" />

3. Pour utiliser l’authentification par clé, cliquez sur « Revoke and generate key pair » pour générer une nouvelle paire de clés, puis copiez la clé publique générée sur votre serveur SSH dans `~/.ssh/authorized_keys`.

4. Cliquez sur « Verify Connection » pour vérifier la connexion.

<Note>
  Assurez-vous d’autoriser les [adresses IP de ClickPipes](/fr/integrations/clickpipes/home#list-of-static-ips) dans les règles de votre pare-feu pour l’hôte bastion SSH afin que ClickPipes puisse établir le tunnel SSH.
</Note>

Une fois les informations de connexion renseignées, cliquez sur `Next`.

<div id="advanced-settings">
  #### Configurer les paramètres avancés
</div>

Vous pouvez configurer les paramètres avancés si nécessaire. Une brève description de chaque paramètre est fournie ci-dessous :

* **Intervalle de synchronisation** : il s’agit de l’intervalle auquel ClickPipes interroge la base de données source pour détecter les changements. Cela a un impact sur le service ClickHouse de destination ; pour les utilisateurs sensibles aux coûts, nous recommandons de conserver une valeur élevée (supérieure à `3600`).
* **Threads parallèles pour le chargement initial** : il s’agit du nombre de workers parallèles utilisés pour récupérer l’instantané initial. Cela est utile lorsque vous avez un grand nombre de tables et que vous souhaitez contrôler le nombre de workers parallèles utilisés pour récupérer l’instantané initial. Ce paramètre s’applique à chaque table.
* **Taille du lot d’extraction** : le nombre de lignes à récupérer en un seul lot. Il s’agit d’un paramètre appliqué au mieux, qui peut donc ne pas être respecté dans tous les cas.
* **Nombre de lignes de l’instantané par partition** : il s’agit du nombre de lignes récupérées dans chaque partition pendant l’instantané initial. Cela est utile lorsque vos tables contiennent un grand nombre de lignes et que vous souhaitez contrôler le nombre de lignes récupérées dans chaque partition.
* **Nombre de tables de l’instantané en parallèle** : il s’agit du nombre de tables récupérées en parallèle pendant l’instantané initial. Cela est utile lorsque vous avez un grand nombre de tables et que vous souhaitez contrôler le nombre de tables récupérées en parallèle.

<div id="configure-the-tables">
  ### Configurer les tables
</div>

5. Ici, vous pouvez sélectionner la base de données de destination de votre ClickPipe. Vous pouvez soit sélectionner une base de données existante, soit en créer une nouvelle.

   <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/select-destination-db.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=0d0e2ccff52ddb8922cc377a3490ba14" alt="Sélectionner la base de données de destination" size="lg" border width="2368" height="614" data-path="images/integrations/data-ingestion/clickpipes/mysql/select-destination-db.png" />

6. Vous pouvez sélectionner les tables que vous souhaitez répliquer depuis la base de données MySQL source. Lors de cette sélection, vous pouvez également renommer les tables dans la base de données ClickHouse de destination et exclure des colonnes spécifiques.

<div id="review-permissions-and-start-the-clickpipe">
  ### Vérifiez les permissions et démarrez le ClickPipe
</div>

7. Sélectionnez le rôle « Accès complet » dans le menu déroulant des permissions, puis cliquez sur « Terminer la configuration ».

   <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/kkh98eOd_iRyUp1R/images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg?fit=max&auto=format&n=kkh98eOd_iRyUp1R&q=85&s=4a4e80310a3161ee75b735a51ef9af20" alt="Vérifiez les permissions" size="lg" border width="1844" height="716" data-path="images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg" />

Enfin, consultez la page ["FAQ de ClickPipes for MySQL"](/fr/integrations/clickpipes/mysql/faq) pour plus d’informations sur les problèmes courants et leur résolution.

<div id="whats-next">
  ## Et ensuite ?
</div>

[//]: # "TODO Rédiger un guide de migration spécifique à MySQL ainsi que des bonnes pratiques similaires à celles qui existent déjà pour PostgreSQL. Le guide de migration actuel renvoie vers le moteur de table MySQL, ce qui n'est pas idéal."

Une fois votre ClickPipe configuré pour répliquer les données de MySQL vers ClickHouse Cloud, vous pouvez vous concentrer sur la façon d'interroger et de modéliser vos données afin d'obtenir des performances optimales. Pour les questions fréquentes sur MySQL CDC et la résolution des problèmes, consultez la [page des FAQ MySQL](/fr/integrations/clickpipes/mysql/faq).