Saltar al contenido

Conector de base de datos para Jitterbit Studio

Resumen

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

Nota

Jitterbit ofrece una serie de conectores específicos para aplicaciones para bases de datos comúnmente utilizadas. Para una lista completa, consulta Conectores.

El conector de base de datos proporciona una interfaz para crear una Conexión de base de datos, que es 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.

El conector de base de datos se accede desde la pestaña Puntos finales y conectores del proyecto en 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 actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

Juntos, una conexión de base de datos específica y sus actividades se denominan un punto final de base de datos:

Tipos de actividades de base de datos

  • Consulta: Consulta datos de un punto final de base de datos y está destinada a ser utilizada como fuente en una operación o llamada en un script.

  • Insertar: Inserta nuevos datos en un punto final de base de datos y está destinada a ser utilizada como destino en una operación o llamada en un script.

  • Actualizar: Actualiza datos existentes en un punto final de base de datos y está destinada a ser utilizada como destino en una operación o llamada en un script.

  • Upsert: Actualiza datos existentes e inserta nuevos datos en un punto final de base de datos y está destinado a ser utilizado como un objetivo en una operación o llamado en un script. (Harmony admite actividades de Upsert para bases de datos utilizando una combinación de Consulta, Inserción y Actualización.)

Consejo

Dado que no hay una actividad de Eliminar en la base de datos, para eliminar datos de una conexión de base de datos, utiliza la función DBExecute en un Jitterbit Script especificando el comando SQL que se ejecutará contra la base de datos.

Nota

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

Los puntos finales creados con este conector están incluidos en el informe de uso de puntos finales y cuentan para tu licencia.

Versiones compatibles y limitaciones

Bases de datos compatibles

Se admiten la mayoría de las bases de datos compatibles con JDBC y ODBC. Tu elección de agente también afecta qué tipo de controlador puedes usar, 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 comúnmente utilizados:

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

Agentes privados

Los agentes privados admiten controladores JDBC y ODBC. Para los controladores ODBC, la arquitectura del controlador debe coincidir con el sistema 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 (JDBC 19.7)
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server (jTDS)
  • SQL Server (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, puedes instalar otros controladores de base de datos en agentes privados según sea necesario. Para información general e instrucciones sobre cómo instalar controladores adicionales en agentes privados, consulta Instalar controladores ODBC o JDBC adicionales.

Datos soportados

En bases de datos, Jitterbit no soporta 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 soportadas

Transport Layer Security (TLS) 1.3 y 1.2 son soportados para puntos finales de bases de datos JDBC.

En agentes privados, TLS 1.0 o 1.1 pueden ser reactivados (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 los caracteres utilizados para definir delimitadores dentro de los nombres de tablas/columnas de base de datos en el archivo de configuración del agente privado bajo la sección [DbDrivers].

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

Solución de problemas y cómo hacer

Si experimenta problemas con el conector de base de datos, se recomiendan los siguientes pasos de solución de problemas:

  1. Asegúrese de que la conexión a la 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. Revise los registros de operaciones para obtener información escrita durante la ejecución de la operación.

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

  4. Si utiliza agentes privados, puede revisar los registros de agentes para obtener más información.

  5. Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operaciones.

Además, las siguientes páginas proporcionan instrucciones detalladas sobre cómo realizar ciertas tareas con proyectos de integración que utilizan 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 con bases 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, consulte Funciones de base de datos.