> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Describe cómo conectar sin problemas MongoDB con ClickHouse Cloud.
# Ingesta de datos de MongoDB a ClickHouse (mediante CDC)
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
La ingesta de datos desde MongoDB a ClickHouse Cloud mediante ClickPipes está en beta pública.
En la consola y la documentación de ClickHouse Cloud, "tabla" y "colección" se usan indistintamente para MongoDB.
Puede usar ClickPipes para ingerir datos desde su base de datos de MongoDB a ClickHouse Cloud. La base de datos de MongoDB de origen puede alojarse en instalaciones propias o en la nube mediante servicios como MongoDB Atlas.
Los ClickPipes de MongoDB pueden implementarse y gestionarse manualmente mediante la UI de ClickPipes, así como mediante programación con [OpenAPI](/docs/es/integrations/clickpipes/programmatic-access/openapi) y [Terraform](/docs/es/integrations/clickpipes/programmatic-access/terraform).
## Requisitos previos
Antes de empezar, debes asegurarte de que tu base de datos MongoDB esté correctamente configurada para la replicación. Los pasos de configuración dependen de cómo hayas desplegado MongoDB, así que sigue la guía correspondiente a continuación:
1. [MongoDB Atlas](/docs/es/integrations/clickpipes/mongodb/source/atlas)
2. [Generic MongoDB](/docs/es/integrations/clickpipes/mongodb/source/generic)
3. [Amazon DocumentDB](/docs/es/integrations/clickpipes/mongodb/source/documentdb)
Una vez configurada tu base de datos MongoDB de origen, puedes continuar con la creación de tu ClickPipe.
## Crea tu ClickPipe
Asegúrate de haber iniciado sesión en tu cuenta de ClickHouse Cloud. Si aún no tienes una cuenta, puedes registrarte [aquí](https://cloud.clickhouse.com/).
1. En la consola de ClickHouse Cloud, ve a tu servicio de ClickHouse Cloud.
2. Selecciona el botón `Data Sources` en el menú lateral izquierdo y haz clic en "Set up a ClickPipe".
3. Selecciona la tarjeta `MongoDB CDC`.
### Agrega la conexión a tu base de datos MongoDB de origen
4. Completa los datos de conexión de tu base de datos MongoDB de origen que configuraste en el paso de requisitos previos.
Antes de empezar a agregar los datos de conexión, asegúrate de haber permitido las direcciones IP de ClickPipes en las reglas de tu firewall. En la siguiente página puedes encontrar una [lista de direcciones IP de ClickPipes](/docs/es/integrations/clickpipes/home#list-of-static-ips).
Para obtener más información, consulta las guías de configuración de MongoDB de origen enlazadas [al inicio de esta página](#prerequisites).
#### (Opcional) Cambiar la configuración de TLS
De forma predeterminada, su ClickPipe se creará con TLS habilitado y con verificación del certificado. Estos valores predeterminados se pueden modificar al crear el ClickPipe:
O bien, editarse en la sección *Configuración de la conexión* de la pestaña *Configuración* de su ClickPipe pausado:
Donde:
* `Disable TLS` activa o desactiva TLS para la conexión. Desactivar TLS significa que los datos se envían como texto sin cifrar por la red, lo que puede incluir secretos y datos confidenciales.
* `Skip certificate verification` activa o desactiva la verificación del certificado presentado por la base de datos de origen. Tenga en cuenta las implicaciones de seguridad de omitir la verificación del certificado.
* `TLS Host` (opcional; de forma predeterminada, el *Host* de origen) es el hostname con el que debe coincidir el CN del certificado cuando la verificación del certificado está habilitada.
* `Upload CA` puede usarse para proporcionar una CA cuando la verificación del certificado está habilitada.
#### (Opcional) Configurar la tunelización SSH
Puede especificar los detalles de la tunelización SSH si su base de datos MongoDB de origen no es accesible públicamente.
1. Active el interruptor "Usar tunelización SSH".
2. Complete los detalles de la conexión SSH.
3. Para usar autenticación basada en claves, haga clic en "Revocar y generar par de claves" para generar un nuevo par de claves y copie la clave pública generada en su servidor SSH, en `~/.ssh/authorized_keys`.
4. Haga clic en "Verificar conexión" para verificar la conexión.
Asegúrese de permitir las [dirección IP de ClickPipes](/docs/es/integrations/clickpipes/home#list-of-static-ips) en las reglas de su firewall para el host bastión SSH, de modo que ClickPipes pueda establecer el túnel SSH.
Una vez completados los detalles de la conexión, haga clic en `Siguiente`.
#### Configurar ajustes avanzados
Puede configurar los ajustes avanzados si es necesario. A continuación, se ofrece una breve descripción de cada ajuste:
* **Intervalo de sincronización**: Es el intervalo con el que ClickPipes consultará la base de datos de origen para detectar cambios. Esto influye en el servicio de ClickHouse de destino; para los usuarios con restricciones de costos, recomendamos mantenerlo en un valor más alto (por encima de `3600`).
* **Tamaño del lote de extracción**: El número de filas que se recuperarán en un solo lote. Este ajuste es orientativo y puede que no se respete en todos los casos.
* **Número de tablas de la instantánea en paralelo**: Es el número de tablas que se recuperarán en paralelo durante la instantánea inicial. Resulta útil cuando tiene un gran número de tablas y desea controlar cuántas se recuperan en paralelo.
### Configura las tablas
5. Aquí puedes seleccionar la base de datos de destino para tu ClickPipe. Puedes seleccionar una base de datos existente o crear una nueva.
6. Puedes seleccionar las tablas que quieres replicar desde la base de datos MongoDB de origen. Al seleccionar las tablas, también puedes optar por cambiarles el nombre en la base de datos de destino de ClickHouse.
### Revisa los permisos e inicia el ClickPipe
7. Selecciona el rol "Acceso completo" en el menú desplegable de permisos y haz clic en "Completar configuración".
## ¿Qué sigue?
Una vez que hayas configurado tu ClickPipe para replicar datos de MongoDB en ClickHouse Cloud, puedes centrarte en cómo consultar y modelar tus datos para obtener un rendimiento óptimo.
## Consideraciones
Estas son algunas consideraciones que debes tener en cuenta al usar este conector:
* Requerimos MongoDB versión 5.1.0 o superior.
* Usamos la API nativa de Change Streams de MongoDB para CDC, que se basa en el oplog de MongoDB para capturar cambios en tiempo real.
* Los documentos de MongoDB se replican en ClickHouse como JSON type de forma predeterminada. Esto permite una gestión flexible del schema y hace posible usar el amplio conjunto de operadores JSON de ClickHouse para realizar consultas y análisis. Puedes obtener más información sobre cómo consultar datos JSON [aquí](/docs/es/reference/data-types/newjson).
* La configuración de PrivateLink de autoservicio no está disponible actualmente. Si usas AWS y necesitas PrivateLink, ponte en contacto con [db-integrations-support@clickhouse.com](mailto:db-integrations-support@clickhouse.com) o crea un ticket de soporte; trabajaremos contigo para habilitarlo.