MongoDB en Jitterbit Design Studio

Introducción

Para los propósitos de este artículo, se asume que ya has obtenido, instalado y comenzado una instancia de un servidor MongoDB. Además, una vez que hayas definido tu modelo de datos y su estructura, deberías crear una copia en JSON de la estructura que se puede usar para realizar ingeniería inversa de un archivo XSD. Esto se mostrará más adelante en este documento.

Requisitos del sistema

Necesitarás obtener un controlador JDBC o ODBC que haya sido escrito específicamente para MongoDB. Se recomienda que obtengas una prueba gratuita del controlador y realices pruebas antes de hacer una compra final.

Configuración

Cómo conectarse a una instancia de MongoDB usando Jitterbit

Instala el controlador en el dispositivo que se utilizará para alojar tu agente privado. Si has instalado un controlador ODBC, entonces ese controlador debería mostrarse dentro de Jitterbit Studio como una posible selección al elegir crear un Origen o un Destino que haga uso de una base de datos. Esta imagen muestra un nuevo Origen que fue creado usando un controlador ODBC:

Se debe mencionar que no todos los controladores ofrecerán la misma funcionalidad dentro de Jitterbit Studio y, como tal, se te anima a realizar tus propias pruebas antes de elegir qué controlador deseas usar.

Si has instalado un controlador JDBC, entonces deberías consultar la documentación de ese controlador para obtener la Clase y el Subprotocolo. Querrás tomar nota de dónde has instalado el controlador JDBC, ya que necesitarás copiar el archivo JAR recién instalado (y probablemente un archivo de licencia) a una ubicación que sea conocida y utilizada por el servidor Tomcat de Jitterbit.

Localiza la carpeta en tu sistema donde se encuentra el archivo JdbcDrivers.conf. Para Windows, esta es C:\Program Files (x86)\Jitterbit Agent. Abre el archivo JdbcDrivers.conf y sigue las instrucciones dentro del archivo que describen cómo "Registrar un nuevo controlador JDBC con Jitterbit".

En el ejemplo de instalación de un controlador JDBC en un sistema operativo Windows, esta información se agregó al archivo JdbcDrivers.conf:

<Driver>

      <Name>MongoDB</Name>

      <Class>cdata.jdbc.mongodb.MongoDBDriver</Class>

      <Subprotocol>jdbc:mongodb</Subprotocol>

</Driver>

Una vez instalado, reinicia el servidor Tomcat, ya que esto permitirá que el controlador JDBC recién instalado aparezca como una posible selección al configurar una nueva fuente o destino de base de datos. Aquí hay una imagen de cómo se creó manualmente la cadena de conexión para la instancia de MongoDB:

Como se mencionó anteriormente, no todos los controladores ofrecerán la misma funcionalidad, por lo que es importante realizar tus propias pruebas antes de tomar una decisión. La documentación restante se realizó utilizando un controlador JDBC que permite escribir declaraciones SQL contra una instancia de MongoDB.

El siguiente paso es poder escribir datos de una fuente de datos a tu instancia de MongoDB. En el escenario específico mostrado aquí, se creó una tabla simple utilizando una base de datos PostgreSQL. Luego, podría poblar varias filas de datos que se utilizarían para escribir la colección de MongoDB que se había creado previamente.

Dentro de Jitterbit Studio, se creó un nuevo proyecto llamado MongoDB con fines de prueba. Luego, crea un nuevo tipo de operación de transformación que utilizará la base de datos PostgreSQL como fuente y la instancia de MongoDB como destino. La siguiente imagen ilustra el resultado antes de configurar la transformación acompañante.

Selecciona la transformación y elige una nueva transformación del menú. Esto iniciará el asistente de transformación. Si la fuente y el destino ya están creados, solo necesitarás nombrar la nueva transformación.

Luego, haga clic en "Siguiente" dentro del Asistente de Transformación.

Para ver una lista de tablas que pueden ser utilizadas desde su definición de Origen, haga clic en el botón "Descargar lista de tablas". Seleccione su tabla de Origen y haga clic en el nombre para mover su tabla a la vista de Tablas Seleccionadas. Una vez que haya seleccionado sus tablas de Origen, puede hacer clic en Siguiente dentro del Asistente de Transformación. Elija cualquier valor requerido que sea apropiado para su integración y avance a través del Asistente de Transformación hasta que se le presente la pantalla de DESTINO. Si ya ha designado el Destino como la instancia de MongoDB, puede descargar la lista de tablas (colecciones) que se han configurado. Dentro de la instancia de MongoDB, haga clic en el botón "Descargar lista de tablas". En este ejemplo, hay dos colecciones que se añadieron previamente a mi instancia de MongoDB llamadas data y test. Seleccione la tabla (colección) que se necesita para su propósito específico de integración y mueva esa selección a la vista de Tablas Seleccionadas.

En este ejemplo, se seleccionó Insertar/Actualizar. Esto es posible una vez que el destino ha definido una Clave Primaria para la colección de la instancia de MongoDB subyacente que se está utilizando. Puede determinar su Clave Primaria haciendo clic en el botón "Editar tabla seleccionada…" y luego seleccionando el campo que se utilizará como Clave Primaria.

Cuando haya terminado, haga clic en el botón "Finalizar" para salir del Asistente de Transformación.

Al salir del Asistente de Transformación, se le presentará la estructura subyacente de sus datos de Origen y Destino. En este caso, es una tabla de PostgreSQL muy simple como Origen y una estructura de colección de MongoDB igualmente simple. Sin embargo, es importante notar que la estructura real de MongoDB ha sido diseñada para parecer aplanada dentro del Destino de Transformación. Como verá, los datos reales que se han insertado en esta instancia de MongoDB contienen datos en una estructura más jerárquica de lo que uno podría percibir si simplemente observa el Destino de Transformación. El siguiente paso es completar cualquier mapeo que sea necesario.

Cuando hayas terminado de mapear tus datos de la Fuente al Destino, guarda tus cambios y cierra la Transformación. Ahora deberías poder ejecutar tu Operación, que insertará los datos de tu Fuente a tu Destino. A continuación se muestra una imagen que muestra el resultado de ejecutar la Operación e insertar con éxito los datos de PostgreSQL en esta colección de MongoDB.

Este documento está destinado a ser un ejemplo simple de cómo usar Jitterbit para conectarse a una instancia de MongoDB y luego insertar datos de una Fuente a tu Destino. En la mayoría de los casos, una Integración puede necesitar realizar todos los aspectos de una operación CRUD y, como tal, deberías continuar configurando nuevas Operaciones que te permitan realizar todas las operaciones necesarias para tu implementación específica.