Saltar al contenido

Conexión a MongoDB

Introducción

Una conexión a MongoDB, creada utilizando el conector de MongoDB, establece acceso a MongoDB. Una vez que se configura una conexión, se pueden crear instancias de actividades de MongoDB asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión a MongoDB

Se crea una nueva conexión a MongoDB utilizando el conector de MongoDB desde una de estas ubicaciones:

Una conexión a MongoDB existente se puede editar desde estas ubicaciones:

Configurar una conexión a MongoDB

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión a MongoDB se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes para elegir.

  • Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de MongoDB y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de MongoDB, que se refiere tanto a una conexión específica como a sus actividades.

  • Nombre de usuario: Ingresa el nombre de usuario del clúster de MongoDB.

  • Contraseña: Ingresa la contraseña del clúster de MongoDB.

    Nota

    Si no te estás conectando a un clúster de MongoDB existente, consulta los requisitos previos de MongoDB para obtener información sobre la configuración.

  • Conectar usando: Selecciona el método para ingresar la información de conexión, ya sea Formulario o Cadena de conexión.

    • Formulario: Expande los campos donde especificas un Host y una Base de datos para usar en una conexión de MongoDB.

      • Host: Ingresa el nombre de host del clúster de MongoDB.

      • Base de datos: Ingresa el nombre de una base de datos presente en el clúster de MongoDB.

      • Configuraciones opcionales: Haz clic para expandir configuraciones adicionales opcionales:

        • Parámetros adicionales de la cadena de conexión: Ingresa opciones adicionales para la conexión de MongoDB. Para obtener una lista de opciones compatibles, consulta las Opciones de cadena de conexión en la documentación de referencia de MongoDB.

        • Conectar usando una lista de semillas DNS: Selecciona para conectarte usando una lista de semillas DNS en lugar del formato de conexión estándar. Si se selecciona esta configuración, también se recomienda seleccionar Habilitar SSL/TLS. Para más información, consulta el Formato de conexión de lista de semillas DNS en la documentación de referencia de MongoDB.

          Importante

          Tanto Conectar usando una lista de semillas DNS como Habilitar SSL/TLS son requeridos para conectarse a MongoDB en Azure Cosmos DB.

        • Habilitar escrituras reintentables: Seleccionar para reintentar automáticamente las operaciones de escritura. Para más información, ver Escrituras reintentables en la documentación de referencia de MongoDB.

        • Habilitar lecturas reintentables: Seleccionar para reintentar automáticamente las operaciones de lectura. Para más información, ver Lecturas reintentables en la documentación de referencia de MongoDB.

        • Habilitar SSL/TLS: Seleccionar para asegurar la conexión.

    • Cadena de conexión: Expande los campos donde se especifica una cadena de conexión para usar en una conexión MongoDB.

      • URL de conexión: Ingresar la cadena de conexión de MongoDB. Para más información sobre el formato de cadena aceptado en este campo, ver Formato de URI de cadena de conexión en la documentación de referencia de MongoDB.

      • Configuraciones opcionales: Hacer clic para expandir configuraciones opcionales adicionales:

        • Conectar usando una lista de semillas DNS: Seleccionar para conectarse usando una lista de semillas DNS en lugar del formato de conexión estándar. Si se selecciona esta configuración, también se recomienda seleccionar Habilitar SSL/TLS. Para más información, ver Formato de conexión de lista de semillas DNS en la documentación de referencia de MongoDB.

          Importante

          Tanto Conectar usando una lista de semillas DNS como Habilitar SSL/TLS son requeridos para conectarse a MongoDB en Azure Cosmos DB.

        • Habilitar Escrituras Reintentables: Seleccione para reintentar automáticamente las operaciones de escritura. Para más información, consulte Escrituras Reintentables en la documentación de referencia de MongoDB.

        • Habilitar Lecturas Reintentables: Seleccione para reintentar automáticamente las operaciones de lectura. Para más información, consulte Lecturas Reintentables en la documentación de referencia de MongoDB.

        • Habilitar SSL/TLS: Seleccione para asegurar la conexión.

  • Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

    Importante

    Si su conexión está fallando y todo parece correcto, asegúrese de haber incluido en la lista blanca las direcciones IP necesarias descritas en prerrequisitos de MongoDB.

  • Guardar Cambios: Haga clic para guardar y cerrar la configuración de la conexión.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pedirá que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pedirá que confirme que desea eliminar la conexión.

Siguientes pasos

Después de que se ha creado una conexión de MongoDB, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta los menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Consulta: Recupera un objeto de MongoDB y está destinado a ser utilizado como fuente en una operación.

  • Upsert: Actualiza un objeto existente o crea un nuevo objeto en MongoDB y está destinado a ser utilizado como destino en una operación.

  • Insertar: Coloca un objeto en MongoDB y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Coloca un objeto en MongoDB y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina un objeto de MongoDB y está destinado a ser utilizado como destino en una operación.