Saltar al contenido

Base de datos a texto para el curso de capacitación Introducción al Jitterbit Integration Studio

Introducción

El Módulo 1 del curso de capacitación Introducción al Jitterbit Integration Studio demuestra cómo consultar datos de una sola tabla en una base de datos PostgreSQL y escribirlos en un servidor SFTP como un archivo de texto plano.

Requisitos previos

Estos módulos suponen que te has registrado en el Jitterbit Learning Sandbox proporcionado como parte del curso de capacitación Introducción al Jitterbit Integration Studio. El registro en el Jitterbit Learning Sandbox proporciona acceso a la organización de capacitación Harmony, completa con dos entornos, así como cuentas en el servidor SFTP de capacitación de Jitterbit y en la base de datos PostgreSQL.

Si no tienes este acceso, consulta Cómo obtener capacitación para registrarte en Jitterbit University, y luego inscríbete en el curso Introducción al Jitterbit Integration Studio. El registro en el Learning Sandbox se cubre en el Capítulo 4 – Registro en el Learning Sandbox.

Resumen

En este módulo, te conectarás a la tabla customer de la base de datos PostgreSQL de capacitación, crearás un archivo CSV con campos similares y escribirás esos datos en el servidor SFTP de capacitación.

La operación completada se verá así:

operación db a texto

Esta operación utiliza este mapeo de transformación:

db a texto

1. Crear un nuevo proyecto

Todos los módulos cubiertos en este curso se crean en un solo proyecto. Antes de comenzar el primer módulo, crea un proyecto:

  1. Inicia sesión en el portal de Harmony en https://login.jitterbit.com y cambia a la organización Jitterbit Learning Sandbox en la parte superior derecha del encabezado.

  2. Haz clic en la tarjeta de la aplicación Integration Studio.

  3. Desde el índice de proyectos, haz clic en Nuevo Proyecto. Asigna un nombre al proyecto, como "Ejemplos de Jitterbit University", y selecciona el entorno.

  4. Una vez dentro del proyecto, renombra el flujo de trabajo a "Módulo 1".

    Consejo

    Seguir una convención de nombres aceptada dentro de tu organización para tus flujos de trabajo, operaciones y componentes es una buena práctica recomendada.

2. Configurar una conexión a la base de datos

Para este módulo, primero establece una conexión a la base de datos de entrenamiento PostgreSQL:

  1. Desde la paleta de componentes de diseño en la pestaña Puntos finales y conectores del proyecto bajo el filtro Conectores, haz clic en el conector de Base de Datos.

  2. Configura la Conexión a la base de datos:

    • Nombre del punto final: "Base de Datos Postgres"

    • Controlador: "PostgreSQL"

    • Nombre del servidor: "learningsandbox.jitterbit.com"

    • Nombre de la base de datos, Inicio de sesión, Contraseña: Estas credenciales provienen de la información que proporcionaste al completar el formulario de registro de Learning Sandbox. Esta información se puede encontrar en el correo electrónico de confirmación de Learning Sandbox.

    • Puerto: No se necesitan cambios de los valores predeterminados.

    Consejo

    Los agentes en la nube solo pueden usar controladores JDBC, mientras que los agentes privados pueden usar controladores JDBC o ODBC.

  3. Haz clic en Probar en la parte inferior de la configuración para verificar la conectividad.

  4. Una vez conectado, haz clic en Guardar Cambios. Esto te devuelve al lienzo de diseño.

La conexión "Postgres Database" debe tener una configuración similar a esta:

database connection

3. Configurar una actividad de base de datos

A continuación, se configura una actividad para consultar datos de la base de datos PostgreSQL:

  1. En la pestaña Puntos finales y conectores del proyecto del panel de componentes, bajo el filtro Puntos finales, haz clic en la conexión "Postgres Database" que acabas de crear para mostrar los tipos de actividad de la conexión:

    endpoints database activities

  2. Arrastra un tipo de actividad de Consulta de Base de Datos a la zona de caída de componentes en el lienzo de diseño para crear una instancia de una actividad de Consulta de Base de Datos en una nueva operación.

  3. Cambia el nombre de la operación a "DB a Texto."

  4. Haz doble clic en la actividad de Consulta dentro de la operación para abrir su configuración.

  5. Configura la actividad de consulta de base de datos:

    • Nombre: "Consulta Tabla de Clientes"
    • Seleccionar Tabla(s): Actualiza las tablas y selecciona la tabla customer. Haz clic en Siguiente.
    • Seleccionar Campos: Selecciona los campos id (Clave), company, address, city, state, zip, country, phone, y fax. Haz clic en Siguiente.
    • Esquema de Datos: Revisa el esquema de datos y haz clic en Finalizado para regresar al lienzo de diseño.

La pantalla final de configuración de la actividad debería verse similar a esta:

database query step 3 data schema customer

4. Configurar una conexión FTP

A continuación, se configura una conexión al servidor SFTP de entrenamiento:

  1. En la pestaña Puntos finales y conectores del proyecto del panel de componentes, bajo el filtro Conectores, haz clic en el conector FTP.

  2. Configura la conexión FTP:

    • Nombre del Punto Final: "SFTP"
    • Host: "learningsandbox.jitterbit.com"
    • Nombre de Usuario y Contraseña: Estas credenciales son de la información que proporcionaste al completar el formulario de Registro del Learning Sandbox. Esta información se puede encontrar en el correo electrónico de confirmación del Learning Sandbox.

  3. Haz clic en Probar para verificar la conectividad y haz clic en Guardar Cambios cuando termines.

La conexión FTP debe tener una configuración similar a esta:

Conexión FTP

5. Configurar una actividad FTP

Una vez que la conexión FTP esté configurada, configura una actividad de escritura FTP asociada con esa conexión:

  1. Desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes bajo el filtro Puntos finales, haz clic en el punto final FTP que acabas de crear para mostrar los tipos de actividad de la conexión:

    actividades FTP de puntos finales

  2. Arrastra una actividad de escritura FTP a una zona de caída de componentes a la derecha de la actividad de Consulta de Base de Datos dentro de la operación en el lienzo de diseño.

  3. Haz doble clic en la actividad de escritura FTP dentro de la operación para abrir su configuración.

  4. Configura la actividad de escritura FTP:

    • Nombre: "Escribir Registros de Clientes"
    • Ruta: "/" (barra diagonal)
    • Nombre(s) de archivo: "resultado_[fecha]_[hora].csv". Haz clic en Siguiente.
    • Esquema de Datos: Dado que no proporcionaste un esquema, no hay nada que revisar en la segunda pantalla. Haz clic en Finalizado.

6. Configurar una transformación

A continuación, creas una transformación para transformar datos de la fuente de la base de datos al destino FTP:

  1. En el lienzo de diseño, pasa el cursor sobre el área entre la actividad de Consulta de Base de Datos y la actividad de Escritura FTP hasta que aparezca una zona de caída de componentes.
  2. Haz clic en la zona de caída y selecciona Nueva Transformación. Se abrirá una nueva transformación para que la configures:
    • Nombre de la Transformación: "DB a Texto"
    • Fuente: El esquema de origen ya está proporcionado (a la izquierda).
    • Destino: Necesitas definir el esquema de destino (a la derecha). Haz clic en Definir Esquema, luego selecciona Crear Plano. Configura el esquema plano personalizado:
      • Nombre del Esquema: "CSV de Clientes"
      • Agregar Campo: Usa este botón para agregar estos campos: id, Cliente, Dirección, Ciudad, Estado, CódigoPostal, País, Teléfono, y Fax. Una vez que los campos estén agregados, haz clic en Guardar Cambios.
  3. En la parte superior derecha del esquema de destino, haz clic en Automatizar Coincidencias Exactas.
  4. Mapea manualmente (arrastrar y soltar) los campos que no fueron coincidencias exactas: mapea empresa a Cliente, y código postal a CódigoPostal.
  5. En la parte superior del encabezado de la transformación, haz clic en el botón gris Vista Previa para comenzar el proceso de vista previa para probar y validar los mapeos. Haz clic en Siguiente para desplegar los componentes listados y luego haz clic en Finalizado.
  6. La pantalla de vista previa muestra datos poblados desde la fuente y mapeados al destino. Haz clic en las flechas derecha e izquierda para recorrer los datos importados.
  7. Después de revisar los datos, haz clic en Regresar al Flujo de Trabajo. Hacer clic en este botón guarda el trabajo que realizaste en la transformación.

La configuración del esquema plano personalizado debería verse similar a esto:

customer CSV

La vista previa de la transformación debería verse similar a esto:

db to text

7. Desplegar y ejecutar la operación

Finalmente, con todos los pasos de la operación configurados, se despliega y ejecuta la operación:

  1. En la parte superior derecha de la operación, haz clic en el ícono del menú de acciones y en el menú haz clic en Desplegar y Ejecutar. El estado de la operación se muestra en la parte inferior izquierda de la operación.
  2. Una vez que la operación sea exitosa, inicia sesión en el servidor SFTP de capacitación de Jitterbit y visualiza el archivo que generaste.