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

> Guide étape par étape pour configurer Amazon DocumentDB comme source pour ClickPipes

# Guide de configuration de la source Amazon DocumentDB

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

<div id="supported-documentdb-versions">
  ## Versions prises en charge de DocumentDB
</div>

ClickPipes prend en charge DocumentDB version 5.0.

<div id="configure-change-stream-log-retention">
  ## Configurer la rétention des journaux du flux de changements
</div>

Par défaut, Amazon DocumentDB conserve les journaux du flux de changements pendant 3 heures, alors que le chargement initial peut prendre bien plus longtemps selon le volume de données déjà présent dans votre instance DocumentDB. Nous vous recommandons de porter cette durée de rétention à 72 heures ou davantage, afin d’éviter qu’ils ne soient supprimés avant la fin du snapshot initial.

<div id="update-change-stream-log-retention-via-aws-console">
  ### Mettre à jour la durée de rétention des journaux du flux de changements via la console AWS
</div>

1. Cliquez sur `Parameter groups` dans le panneau de gauche, puis repérez le groupe de paramètres utilisé par votre cluster DocumentDB (si vous utilisez le groupe de paramètres `default`, vous devrez d’abord en créer un nouveau pour pouvoir le modifier).

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=eca21e67647b7536a207fa6ab631c3a5" alt="Sélectionner le groupe de paramètres" size="lg" border width="2534" height="1266" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png" />

2. Recherchez `change_stream_log_retention_duration`, sélectionnez-le et remplacez sa valeur par `259200` (72 heures)

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=88974ade78f332d1d4a671d3dd59e377" alt="Modifier le groupe de paramètres" size="lg" border width="2524" height="1332" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png" />

3. Cliquez sur `Apply Changes` pour appliquer immédiatement le groupe de paramètres modifié à votre cluster DocumentDB. Vous devriez voir le statut du groupe de paramètres passer à `applying`, puis à `in-sync` une fois la modification appliquée.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-apply-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=76a6d71e46c40ae881a2287298acb350" alt="Appliquer le groupe de paramètres" size="lg" border width="2520" height="1596" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-apply-parameter-group.png" />

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-parameter-group-status.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=9e7ffbde823e858ea739ee8752f8f350" alt="Statut du groupe de paramètres" size="lg" border width="2538" height="694" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-parameter-group-status.png" />

<div id="update-change-stream-log-retention-via-aws-cli">
  ### Mettre à jour la rétention des journaux du flux de changements via l’AWS CLI
</div>

Vous pouvez également effectuer cette configuration via l’AWS CLI.

Pour vérifier la durée actuelle de rétention des journaux du flux de changements :

```shell theme={null}
aws docdb describe-db-cluster-parameters --db-cluster-parameter-group-name <PARAMETER_GROUP_NAME> --query "Parameters[?ParameterName=='change_stream_log_retention_duration'].{Name:ParameterName,Value:ParameterValue}"
```

Pour définir la durée de rétention des journaux du flux de changements à 72 heures :

```shell theme={null}
aws docdb modify-db-cluster-parameter-group --db-cluster-parameter-group-name <PARAMETER_GROUP_NAME> --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=259200,ApplyMethod=immediate"
```

<div id="configure-database-user">
  ## Configurer un utilisateur de base de données
</div>

Connectez-vous à votre cluster DocumentDB en tant qu’administrateur et exécutez la commande suivante pour créer un utilisateur de base de données destiné à ClickPipes pour le CDC MongoDB :

```javascript theme={null}
db.getSiblingDB("admin").createUser({
    user: "clickpipes_user",
    pwd: "some_secure_password",
    roles: ["readAnyDatabase", "clusterMonitor"],
})
```

<Note>
  Veillez à remplacer `clickpipes_user` et `some_secure_password` par le nom d’utilisateur et le mot de passe souhaités.
</Note>

<div id="whats-next">
  ## Quelle est la suite ?
</div>

Vous pouvez maintenant [créer votre ClickPipe](/fr/integrations/clickpipes/mongodb/index) et commencer à ingérer des données de votre instance DocumentDB dans ClickHouse Cloud.
Veillez à noter les informations de connexion utilisées lors de la configuration de votre cluster DocumentDB, car vous en aurez besoin lors du processus de création du ClickPipe.