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

> Décrit comment connecter facilement MongoDB à ClickHouse Cloud.

# Ingestion de données de MongoDB 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 MongoDB vers ClickHouse Cloud via ClickPipes est en bêta publique.
</Info>

<Note>
  Dans la console de ClickHouse Cloud et la documentation, "table" et "collection" sont employés indifféremment pour MongoDB.
</Note>

Vous pouvez utiliser ClickPipes pour ingérer des données depuis votre base de données MongoDB dans ClickHouse Cloud. La base de données source MongoDB peut être hébergée sur site ou dans le cloud à l’aide de services comme MongoDB Atlas.

Les ClickPipes MongoDB peuvent être déployés et gérés manuellement à l’aide de l’interface utilisateur de ClickPipes, 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>

Pour commencer, vous devez d’abord vous assurer que votre base de données MongoDB est correctement configurée pour la réplication. Les étapes de configuration dépendent de la manière dont vous déployez MongoDB ; veuillez donc suivre le guide correspondant ci-dessous :

1. [MongoDB Atlas](/fr/integrations/clickpipes/mongodb/source/atlas)

2. [Generic MongoDB](/fr/integrations/clickpipes/mongodb/source/generic)

3. [Amazon DocumentDB](/fr/integrations/clickpipes/mongodb/source/documentdb)

Une fois votre base de données MongoDB source configurée, vous pouvez poursuivre la création de 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/).

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/6Mo4c7nCBpHK0wy7/images/integrations/data-ingestion/clickpipes/cp_service.png?fit=max&auto=format&n=6Mo4c7nCBpHK0wy7&q=85&s=0728ef7df1f7f9eb28e563d16328b06b" 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-67bc7bf8/6Mo4c7nCBpHK0wy7/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=6Mo4c7nCBpHK0wy7&q=85&s=c2214964b5ee55ac7472f2f08ae20aa2" 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 `MongoDB CDC`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/6Mo4c7nCBpHK0wy7/images/integrations/data-ingestion/clickpipes/mongodb/mongodb-tile.png?fit=max&auto=format&n=6Mo4c7nCBpHK0wy7&q=85&s=89261250275980371f43f1a696d93826" alt="Sélectionner MongoDB" size="lg" border width="1802" height="986" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongodb-tile.png" />

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

4. Renseignez les détails de connexion de votre base de données source MongoDB, que vous avez configurée à l’étape des prérequis.

<Info>
  Avant de commencer à ajouter vos détails de connexion, assurez-vous d’avoir autorisé les adresses IP de ClickPipes dans vos règles de 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 source MongoDB liés [en haut de cette page](#prerequisites).
</Info>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/6Mo4c7nCBpHK0wy7/images/integrations/data-ingestion/clickpipes/mongodb/mongodb-connection-details.png?fit=max&auto=format&n=6Mo4c7nCBpHK0wy7&q=85&s=585b1b3bde64d88b79e84596ef417a29" alt="Renseignez les détails de connexion" size="lg" border width="1538" height="1698" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongodb-connection-details.png" />

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

Vous pouvez spécifier les informations du tunnel SSH si votre base de données source MongoDB n'est pas accessible publiquement.

1. Activez le bouton bascule « Utiliser le tunnel SSH ».

2. Renseignez les informations de connexion SSH.

   <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/VOUe3z-tehHaD879/images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg?fit=max&auto=format&n=VOUe3z-tehHaD879&q=85&s=febdedc61dfc16ee8aacb99776744812" 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 « Révoquer et générer une paire de clés » 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 « Vérifier la connexion » pour valider la connexion.

<Note>
  Assurez-vous d'autoriser les [adresse IP de ClickPipes](/fr/integrations/clickpipes/home#list-of-static-ips) dans vos règles de 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 :

* **Sync interval** : il s'agit de l'intervalle auquel ClickPipes interroge la base de données source pour détecter des changements. Cela a un impact sur le service ClickHouse de destination ; pour les utilisateurs attentifs aux coûts, nous recommandons de conserver une valeur plus élevée (supérieure à `3600`).
* **Pull batch size** : le nombre de lignes à récupérer en une seule fois. Il s'agit d'un paramètre appliqué au mieux, qui peut ne pas être respecté dans tous les cas.
* **Snapshot number of tables in parallel** : il s'agit du nombre de tables qui seront récupérées en parallèle pendant le snapshot initial. Cela est utile si vous avez un grand nombre de tables et 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-67bc7bf8/6Mo4c7nCBpHK0wy7/images/integrations/data-ingestion/clickpipes/mongodb/select-destination-db.png?fit=max&auto=format&n=6Mo4c7nCBpHK0wy7&q=85&s=b996bc52680b86e0c98c1249c14f9f48" alt="Sélectionner la base de données de destination" size="lg" border width="1742" height="548" data-path="images/integrations/data-ingestion/clickpipes/mongodb/select-destination-db.png" />

6. Vous pouvez sélectionner les tables que vous souhaitez répliquer depuis la base de données source MongoDB. Lors de la sélection des tables, vous pouvez également choisir de les renommer dans la base de données ClickHouse de destination.

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

7. Sélectionnez le rôle « Full access » dans le menu déroulant des autorisations, puis cliquez sur « Complete Setup ».

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

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

Une fois votre ClickPipe configuré pour répliquer les données de MongoDB vers ClickHouse Cloud, vous pouvez vous concentrer sur la façon d’interroger et de modéliser vos données pour des performances optimales.

<div id="caveats">
  ## Points à noter
</div>

Voici quelques points à noter lors de l'utilisation de ce connecteur :

* MongoDB version 5.1.0 ou ultérieure est requise.
* Nous utilisons l'API native Change Streams de MongoDB pour le CDC, qui s'appuie sur l'oplog de MongoDB pour capturer les changements en temps réel.
* Les documents MongoDB sont répliqués dans ClickHouse au format JSON type par défaut. Cela permet une gestion flexible du schéma et l'utilisation du riche ensemble d'opérateurs JSON de ClickHouse pour les requêtes et l'analytics. Vous pouvez en savoir plus sur l'interrogation des données JSON [ici](/fr/reference/data-types/newjson).
* La configuration PrivateLink en self-service n'est pas disponible pour le moment. Si vous utilisez AWS et avez besoin de PrivateLink, veuillez contacter [db-integrations-support@clickhouse.com](mailto:db-integrations-support@clickhouse.com) ou créer un ticket de support — nous travaillerons avec vous pour l'activer.