Saltar al contenido

Módulo 1: Base de datos a texto

Introducción

Módulo 1 de la Introducción al Jitterbit Integration Studio el curso de capacitación 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.

Prerrequisitos

Estos módulos suponen que se ha registrado en el Jitterbit Learning Sandbox que se proporciona como parte de la Introducción a Jitterbit Integration Studio curso de capacitación. La inscripción en Jitterbit Learning Sandbox brinda acceso a la organización de capacitación Harmony, con dos ambientes, así como cuentas en el servidor SFTP de capacitación de Jitterbit y la base de datos PostgreSQL.

Si no tiene este acceso, consulte Obtener capacitación para registrarse en la Universidad Jitterbit, luego inscríbase en la Introducción a Jitterbit Integration Studio curso. El registro en el ambiente de aprendizaje se trata en el Capítulo 4: Registro en el ambiente de aprendizaje.

Resumen

En este módulo, te conectarás con el customer tabla de la base de datos PostgreSQL de entrenamiento, cree un archivo CSV con campos similares y escriba esos datos en el servidor SFTP de entrenamiento.

La operación completada se verá así:

operación db a texto

Esta operación utiliza esta asignación de transformación:

db a texto

1. Crea un nuevo proyecto

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

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

  2. Haga clic en el Integration Studio Tarjeta de solicitud.

  3. Desde el índice del proyecto, haga clic en Nuevo proyecto. Déle un nombre al proyecto, como "Ejemplos de Jitterbit University", y seleccione el ambiente.

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

    Consejo

    Se recomienda seguir una convención de nomenclatura aceptada dentro de su organización para sus flujos de trabajo, operaciones y componentes.

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

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

  1. Desde la paleta de componentes de diseño En la pestaña extremos y conectores del proyecto, bajo el filtro Conectores, haga clic en el conector de base de datos.

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

    • Nombre del Extremo: "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 son de la información que proporcionó al completar el formulario de registro de Learning Sandbox. Esta información se puede encontrar en el correo de confirmación de Learning Sandbox.

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

    Consejo

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

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

  4. Una vez conectado, haga clic en Guardar cambios. Esto lo llevará de regreso al tela de diseño.

La conexión "Base de datos Postgres" debe tener una configuración similar a esta:

conexión a base de datos

3. Configurar una actividad de base de datos

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

  1. Desde la pestaña extremos y conectores del proyecto de la paleta de componentes, bajo el filtro Extremos, haga clic en la conexión "Base de datos Postgres" que acaba de crear para mostrar los tipos de actividad de la conexión:

    actividades de la base de datos de extremos

  2. Arrastre un tipo de actividad de consulta de base de datos a la área de inserción de componentes en el tela de diseño para crear una instancia de una actividad de consulta de base de datos en una nueva operación.

  3. Cambie el nombre de la operación a "DB a texto".

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

  5. Configure la Actividad de consultar de base de datos:

    • Nombre: "Consulta de tabla de clientes"
    • Seleccionar tabla(s): Actualice las tablas y seleccione la customer tabla. Haga clic en Siguiente.
    • Seleccionar campos: Seleccione los id (Llave), company, address, city, state, zip, country, phone, y fax campos. Haga clic en Siguiente.
    • Esquema de datos: Revise el esquema de datos y haga clic en Terminado para regresar al tela de diseño.

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

esquema de datos del cliente del paso 3 de la consultar de base de datos

4. Configurar una conexión FTP

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

  1. Desde la pestaña extremos y conectores del proyecto de la paleta de componentes, bajo el filtro Conectores, haga clic en el conector FTP.

  2. Configure la conexión FTP:

    • Nombre del Extremo: "SFTP"
    • Anfitrión: "learningsandbox.jitterbit.com"
    • Nombre de usuario y Contraseña: Estas credenciales son de la información que proporcionaste al completar el formulario de registro de Learning Sandbox. Esta información se puede encontrar en el correo de confirmación de Learning Sandbox.
  3. Haga clic en Probar para verificar la conectividad y haga clic en Guardar cambios cuando haya terminado.

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

Conexión FTP

5. Configurar una actividad FTP

Una vez configurada la conexión FTP, configure una actividad de escritura FTP asociada con esa conexión:

  1. Desde la pestaña Conectores y extremos del proyecto de la paleta de componentes, bajo el filtro Extremos, haga clic en el extremo FTP que acaba de crear para mostrar los tipos de actividad de la conexión:

    actividades FTP de extremos

  2. Arrastre una actividad de escritura FTP a una área de inserción de componentes a la derecha de la actividad de consulta de base de datos dentro de la operación en el tela de diseño.

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

  4. Configure la actividad de escritura FTP:

    • Nombre: "Escribir registros de clientes"
    • Ruta: "/" (barra diagonal)
    • Nombre(s) de archivo(s): "result_[fecha]_[hora].csv". Haga clic en Siguiente.
    • Esquema de datos: Como no proporcionaste un esquema, no hay nada que revisar en la segunda pantalla. Haz clic en Terminado.

6. Configurar una transformación

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

  1. En el tela de diseño, pase el cursor sobre el área entre la actividad de Consulta de base de datos y la actividad de Escritura FTP hasta que aparezca una área de inserción de componentes.
  2. Haga clic en la área de inserción y seleccione Nueva Transformación. Se abrirá una nueva transformación para que la configure:
    • Nombre de la Transformación: "DB a texto"
    • Fuente: El esquema fuente ya se proporciona (a la izquierda).
    • Objetivo: Debe definir el esquema de destino (a la derecha). Haga clic en Definir esquema y, a continuación, seleccione Crear plano. Configure el esquema plano personalizado:
      • Nombre del esquema: "CSV del cliente"
      • Agregar campo: Use este botón para agregar estos campos: id, Customer, Address, City, State, ZipCode, Country, Phone, y Fax Una vez agregados los campos, haga clic en Guardar cambios.
  3. En la parte superior derecha del esquema de destino, haga clic en Autoasignar coincidencias exactas.
  4. Asigne manualmente (arrastre y suelte) los campos que no coincidan exactamente: map company a Customer, y zip a ZipCode.
  5. En la parte superior del encabezado de transformación, haga clic en el botón gris Vista previa para comenzar el proceso de vista previa para probar y validar las asignaciones. Haga clic en Siguiente para desplegar los componentes enumerados y luego haga clic en Terminado.
  6. La pantalla de vista previa muestra los datos ingresados desde la fuente y asignados al destino. Haga clic en las flechas derecha e izquierda para recorrer los datos importados.
  7. Después de revisar los datos, haga clic en Volver al Flujo de trabajo. Al hacer clic en este botón, se guarda el trabajo que realizó en la transformación.

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

CSV del cliente

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

db a texto

7. Desplegar y ejecutar la operación

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

  1. En la parte superior derecha de la operación, haga clic en el ícono del menú de acciones menú de acciones 5 y, desde el menú, haga 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, inicie sesión en el servidor SFTP de entrenamiento de Jitterbit y ver el archivo que has generado.