Conector de base de datos para Jitterbit Integration 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 Jitterbit o instalado en agentes privados Jitterbit.
Nota
Jitterbit ofrece varios conectores específicos para cada aplicación, para bases de datos de uso común. Para obtener una lista completa, consulte Conectores el conector de base de datos proporciona una interfaz para crear una conexión de base de datos, la base para generar instancias de actividades de la 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 y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño)
Descripción general del conector
Este conector se utiliza para configurar inicialmente una conexión a la base de datos. Los tipos de actividad asociados a dicha conexión se utilizan posteriormente para crear instancias de actividades que se utilizarán 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:
-
Consulta: Consulta datos de un extremo de base de datos y está destinado a ser utilizado como fuente en una operación o llamado en un secuencia de comandos.
-
Insertar: Inserta datos nuevos en un extremo de base de datos y está destinado a ser utilizado como destino en una operación o llamado en un secuencia de comandos.
-
Actualizar: Actualiza datos existentes en un extremo de base de datos y está destinado a ser utilizado como destino en una operación o llamado en un secuencia de comandos.
-
Upsert: Actualiza datos existentes e inserta datos nuevos en un extremo de base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos. (Harmony admite actividades Upsert para bases de datos mediante una combinación de consulta, inserción y actualización).
Consejo
Como no hay actividad de eliminación de base de datos, para eliminar datos de una conexión de base de datos, utilice el DBExecute
función en un Jitterbit Script especificando el comando SQL que se ejecutará en la base de datos.
Nota
Este conector es nativo de Integration Studio, al que Jitterbit puede hacer referencia al comunicar cambios realizados en los conectores. El calendario de lanzamiento para los conectores nativos de Integration Studio se basa en la cadencia de las aplicaciones web del portal Harmony.
Versiones compatibles y limitaciones
Bases de datos compatibles
Se admiten la mayoría de las bases de datos compatibles con JDBC y ODBC. Su elección de agente también afecta el tipo de controlador que puedes usar, como agentes de la nube sólo admiten controladores JDBC, mientras que agentes privados compatible con controladores ODBC y JDBC.
Agentes de la nube
Los grupos de agentes de la nube solo admiten controladores JDBC. Se proporciona un conjunto de controladores JDBC de uso común:
- Amazon Redshift
- IBM DB2 (AS400)
- MySQL
- Oracle (JDBC 19.7)
- Oracle NetSuite
- PostgreSQL
- SQL Server jTDS
- SQL Server MS JDBC
- Sybase jTDS
Agentes privados
Los agentes privados admiten controladores JDBC y ODBC. En el caso de los controladores ODBC, su arquitectura debe coincidir con la del 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)
- Unicode de PostgreSQL (x64)
Este controlador ODBC se incluye con la instalación del agente privado de Linux de 64 bits:
- PostgreSQL-jitterbit
Además, puede 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, consulte Instalar controladores ODBC o JDBC adicionales.
Datos admitidos
En bases de datos, Jitterbit no admite datos con estos tipos de codificación o nombres de objeto:
- 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 extremos de bases de datos JDBC.
En los agentes privados, se puede volver a habilitar TLS 1.0 o 1.1 (aunque no se recomienda) eliminando TLSv1
o TLSv1.1
Desde el jdk.tls.disabledAlgorithms
Propiedad de seguridad en el agente privado java.security
Archivo de configuración.
El agente privado java.security
El archivo de configuración se encuentra en estos directorios predeterminados:
-
Windows:
C:\Program Files\Jitterbit Agent\jre\lib\security
-
Linux:
/opt/jitterbit/jre/lib/security
Caracteres especiales en los nombres de tablas y columnas de la base de datos
Si utiliza un agente privado, puede especificar caracteres utilizados para definir delimitadores dentro de los nombres de tablas/columnas de la base de datos dentro del archivo de configuración del agente privado bajo el [DbDrivers]
sección.
Si utiliza un controlador de base de datos ODBC, tenga en cuenta que el controlador no puede procesar algunos caracteres especiales en los nombres de tablas y columnas de la base de datos. Por ejemplo, los campos de base de datos con una arroba (@
) no cumplen con las especificaciones basadas en SQL y podrían no ser compatibles. Si la base de datos utiliza estos caracteres especiales en los nombres de tabla/columna, como solución alternativa, recomendamos crear una vista en la tabla física que no utilice el carácter especial en los nombres de columna y utilizarlo en su lugar.
Solución de problemas y tutoriales
Si tiene problemas con el conector de la base de datos, se recomiendan estos pasos:
-
Asegúrese de que la Conexión a la base de datos se conecta correctamente usando el botón Probar en la pantalla de configuración. Si la conexión no es correcta, el error mostrado puede indicar el problema.
-
Verifique los registros de operación para cualquier información escrita durante la ejecución de la operación.
-
Habilitar el registro de depurar de operación (para agentes de la nube o para agentes privados) para generar archivos de registro y datos adicionales.
-
Si utiliza agentes privados, puede consultar los registros del agente para obtener más información.
-
Para obtener más información sobre la solución de problemas, consulte Solución de problemas de funcionamiento.
Además, las siguientes páginas proporcionan instrucciones detalladas sobre cómo realizar determinadas 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 secuencias de comandos para proporcionar acceso a interacciones básicas de la base de datos, incluyendo las siguientes:
CacheLookup
-CallStoredProcedure
-DBCloseConnection
-DBExecute
-DBLoad
-DBLookup
-DBLookupAll
-DBRollbackTransaction
-DBWrite
-SetDBInsert
-SetDBUpdate
-SQLEscape
-Unmap
-<SEQUENCE>
-<SQLIDENTITY>
-<UDF>
Para obtener más información sobre el uso de estas funciones, consulte Funciones de base de datos.