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

> Guía paso a paso para configurar Amazon DocumentDB como fuente de ClickPipes

# Guía de configuración de Amazon DocumentDB como fuente

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

<div id="supported-documentdb-versions">
  ## Versiones compatibles de DocumentDB
</div>

ClickPipes es compatible con DocumentDB versión 5.0.

<div id="configure-change-stream-log-retention">
  ## Configurar la retención de registros del change stream
</div>

De forma predeterminada, Amazon DocumentDB tiene un período de retención de registros del change stream de 3 horas, mientras que la carga inicial puede tardar bastante más en función del volumen de datos existente en su DocumentDB. Recomendamos establecer la retención de registros del change stream en 72 horas o más para garantizar que no se trunque antes de que se complete la instantánea inicial.

<div id="update-change-stream-log-retention-via-aws-console">
  ### Actualizar la retención de registros del change stream desde la Consola de AWS
</div>

1. Haga clic en `Parameter groups` en el panel izquierdo y busque el grupo de parámetros que usa su clúster de DocumentDB (si está usando el grupo de parámetros predeterminado, primero deberá crear uno nuevo para poder modificarlo).

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=114c5b4713faaf6c9b8ec5c92ea14ffb" alt="Seleccionar grupo de parámetros" size="lg" border width="2534" height="1266" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png" />

2. Busque `change_stream_log_retention_duration`, selecciónelo y cámbielo a `259200` (72 horas)

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=53fc5f5e9108d1bddbc1eefdd9d58408" alt="Modificar grupo de parámetros" size="lg" border width="2524" height="1332" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png" />

3. Haga clic en `Apply Changes` para aplicar de inmediato el grupo de parámetros modificado a su clúster de DocumentDB. Debería ver que el estado del grupo de parámetros cambia primero a `applying` y luego a `in-sync` cuando se aplique el cambio.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/docdb-apply-parameter-group.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=c6998c69e545b99280f21a72af1d8dcd" alt="Aplicar grupo de parámetros" 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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/docdb-parameter-group-status.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=150f1d10c5441391446ffe5bbc9e499b" alt="Estado del grupo de parámetros" 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">
  ### Actualiza la retención de registros del change stream con AWS CLI
</div>

Como alternativa, puedes configurarlo con AWS CLI.

Para comprobar el período actual de retención de registros del change stream:

```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}"
```

Para establecer en 72 horas el período de retención del registro del flujo de cambios:

```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">
  ## Configure un usuario de base de datos
</div>

Conéctese a su clúster de DocumentDB como usuario administrador y ejecute el siguiente comando para crear un usuario de base de datos para ClickPipes de CDC de MongoDB:

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

<Note>
  Asegúrate de sustituir `clickpipes_user` y `some_secure_password` por el nombre de usuario y la contraseña que quieras usar.
</Note>

<div id="whats-next">
  ## ¿Qué sigue?
</div>

Ahora puedes [crear tu ClickPipe](/es/integrations/clickpipes/mongodb) y empezar a ingerir datos desde tu instancia de DocumentDB en ClickHouse Cloud.
Asegúrate de anotar los datos de conexión que usaste al configurar tu clúster de DocumentDB, ya que los necesitarás durante el proceso de creación de ClickPipe.