Overview
Aprende cómo conectar el MongoDB Kafka Connector a MongoDB usando un Identificador Uniforme de Recursos de conexión (URI). Un URI de conexión es un string que contiene la siguiente información:
Se requiere la dirección de su implementación de MongoDB
Configuración de conexión opcional
Configuración de autenticación opcional
Credenciales de autenticación opcional
El siguiente es un ejemplo de URI de conexión para un set de réplicas de MongoDB:
mongodb://mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?replicaSet=myRepl
Para obtener más información sobre el formato URI de la conexión, consulte Formato URI de cadena de conexión en el manual de MongoDB.
Requisitos previos
Para conectar el conector MongoDB Kafka a MongoDB, debe otorgarle al usuario de la base de datos cualquiera de los siguientes:
el
readWriteroltanto los roles de
readAnyDatabasecomo declusterMonitor
Cómo conectarse
Especifique un URI de conexión con la siguiente opción de configuración tanto en un conector de origen como en un conector de destino:
connection.uri=<your connection uri>
Para obtener más información sobre esta opción de configuración, consulta los siguientes recursos:
Cómo configurar su conexión
El Conector Kafka de MongoDB utiliza el controlador Java de MongoDB para analizar tu URI de conexión. El driver Java de MongoDB es un artefacto que permite que aplicaciones Java como Kafka Connect interactúen con MongoDB.
Importante
Versión del controlador
La versión 1.15 del conector MongoDB Kafka utiliza la versión 4.7 del controlador Java MongoDB.
Para saber qué opciones de URI de conexión están disponibles en el conector, consulta la guía de conexión del driver Java de MongoDB.
Autenticación
Todos los mecanismos de autenticación disponibles en el driver Java de MongoDB están disponibles en el Kafka Connector de MongoDB.
A continuación, se muestra un ejemplo de un URI de conexión que se autentica con MongoDB utilizando la autenticación SCRAM-SHA-256:
mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=SCRAM-SHA-256
Importante
Cargar secretos
Para evitar almacenar tus secretos de autenticación como texto plano en tu configuración de connection.uri, carga tus secretos desde una ubicación segura cuando se inicie tu conector. Para aprender a cargar tus secretos al iniciar el conector, lee la guía Externalizar secretos de Confluent.
Para saber qué mecanismos de autenticación están disponibles, consulte la guía de mecanismos de autenticación del controlador Java de MongoDB.
Para aprender más sobre la autenticación en el conector, consulta la Guía de seguridad y autenticación.