Saltar al contenido

Conector de base de datos en Jitterbit Studio

Resumen

El conector de base de datos establece acceso a una base de datos a través de un controlador JDBC u ODBC proporcionado con agentes en la nube de Jitterbit o instalado en agentes privados de Jitterbit.

Nota

Jitterbit ofrece varios conectores específicos de aplicaciones para bases de datos de uso común. Para obtener una lista completa, consulta Conectores.

El conector de base de datos proporciona una interfaz para crear una conexión de base de datos, la base utilizada para generar instancias de actividades de base de datos. Estas actividades, una vez configuradas, interactúan con la base de datos a través de la conexión.

Se accede al conector de base de datos desde la pestaña Extremos del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión de base de datos. Los tipos de actividades asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión de base de datos específica y sus actividades se denominan extremo de base de datos:

Tipos de actividades de base de datos

  • Consulta: Consulta datos de un extremo de base de datos y se pretende utilizar como origen en una operación o llamarse en un script.

  • Insertar: Inserta datos nuevos en un extremo de base de datos y se pretende utilizar como destino en una operación o llamarse en un script.

  • Actualizar: Actualiza datos existentes en un extremo de base de datos y se pretende utilizar como destino en una operación o llamarse en un script.

  • Upsert: Tanto actualiza datos existentes como inserta datos nuevos en un extremo de base de datos y se pretende utilizar como destino en una operación o llamarse en un script. (Harmony admite actividades Upsert para bases de datos utilizando una combinación de Consulta, Insertar y Actualizar.)

Consejo

Como no existe una actividad de eliminación de base de datos, para eliminar datos de una conexión de base de datos, utiliza la función DBExecute en un Script de Jitterbit especificando el comando SQL a ejecutar en la base de datos.

Nota

Este conector es un conector nativo de Studio, al que Jitterbit puede hacer referencia al comunicar cambios realizados en conectores. El calendario de lanzamiento para conectores nativos de Studio se basa en la cadencia de las aplicaciones web del portal Harmony.

Los extremos creados con este conector se incluyen en informes de uso de extremos y cuentan para tu licencia.

Versiones compatibles y limitaciones

Bases de datos compatibles

Se admiten la mayoría de bases de datos compatibles con JDBC y ODBC. Tu elección de agente también afecta qué tipo de controlador puedes utilizar, ya que los agentes en la nube solo admiten controladores JDBC, mientras que los agentes privados admiten tanto controladores ODBC como JDBC.

Agentes en la nube

Los grupos de agentes en la nube solo admiten controladores JDBC. Se proporciona un conjunto de controladores JDBC de uso común:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server MS JDBC (Microsoft)
  • Sybase jTDS

Agentes privados

Los agentes privados admiten controladores JDBC y controladores ODBC. Para controladores ODBC, la arquitectura del controlador debe coincidir con la del agente. Es decir, los agentes de 64 bits admiten controladores ODBC de 64 bits.

Estos controladores JDBC son proporcionados por agentes privados de Windows y Linux de 64 bits:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • IBM DB2 (JCC)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server MS JDBC (Microsoft)
  • SQLite
  • Sybase jTDS

Estos controladores ODBC se incluyen con la instalación del agente privado de Windows de 64 bits:

  • PostgreSQL ANSI (x64)
  • PostgreSQL Unicode (x64)

Este controlador ODBC se incluye con la instalación del agente privado de Linux de 64 bits:

  • PostgreSQL-jitterbit

Además, se pueden instalar otros controladores de base de datos en agentes privados según sea necesario. Para obtener información general e instrucciones sobre la instalación de controladores adicionales en agentes privados, consulta Instalar controladores ODBC o JDBC adicionales.

Datos compatibles

En bases de datos, Jitterbit no admite datos con estos tipos de codificación o nombres de objetos:

  • Datos binarios
  • Datos Unicode/UTF
  • Tablas o vistas con espacios en los nombres

Versiones de TLS compatibles

Se admiten Transport Layer Security (TLS) 1.3 y 1.2 para puntos finales de base de datos JDBC.

En agentes privados, se puede volver a habilitar TLS 1.0 o 1.1 (aunque no se recomienda) eliminando TLSv1 o TLSv1.1 de la propiedad de seguridad jdk.tls.disabledAlgorithms en el archivo de configuración java.security del agente privado.

El archivo de configuración java.security del agente privado se encuentra en estos directorios predeterminados:

  • Windows: C:\Program Files\Jitterbit Agent\jre\lib\security

  • Linux: /opt/jitterbit/jre/lib/security

Caracteres especiales en nombres de tablas/columnas de base de datos

Si utilizas un agente privado, puedes especificar caracteres utilizados para definir delimitadores dentro de nombres de tablas/columnas de base de datos en el archivo de configuración del agente privado bajo la sección [DbDrivers].

Si utilizas un controlador de base de datos ODBC, ten en cuenta que algunos caracteres especiales en nombres de tablas/columnas de base de datos no pueden ser manejados por el controlador. Por ejemplo, los campos de base de datos que tienen un signo de arroba (@) no cumplen con las especificaciones basadas en SQL y es posible que no sean compatibles. Si la base de datos utiliza tales caracteres especiales en nombres de tablas/columnas, como solución alternativa recomendamos crear una vista en la tabla física que no utilice el carácter especial en los nombres de columnas y utilizar esa en su lugar.

Solución de problemas y procedimientos

Si experimentas problemas con el conector de Base de datos, se recomiendan estos pasos para la solución de problemas:

  1. Asegúrate de que la conexión de Base de datos sea exitosa utilizando el botón Probar en la pantalla de configuración. Si la conexión no es exitosa, el error devuelto puede proporcionar una indicación del problema.

  2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si utilizas agentes privados, puedes revisar los registros del agente para obtener más información.

  5. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.

  6. Para problemas y resoluciones específicos del conector de Base de datos, consulta la guía Solución de problemas del conector:

Las siguientes páginas proporcionan instrucciones adicionales para trabajar con el conector de Base de datos:

Recursos adicionales

Se pueden utilizar varias funciones de base de datos dentro de scripts para proporcionar acceso a interacciones básicas de base de datos, incluyendo estas:

  • CacheLookup
  • CallStoredProcedure
  • DBCloseConnection
  • DBExecute
  • DBLoad
  • DBLookup
  • DBLookupAll
  • DBRollbackTransaction
  • DBWrite
  • SetDBInsert
  • SetDBUpdate
  • SQLEscape
  • Unmap
  • <SEQUENCE>
  • <SQLIDENTITY>
  • <UDF>

Para obtener detalles sobre el uso de estas funciones, consulta Funciones de base de datos.