Conector de Base de Datos¶

Resumen¶

El conector de base de datos para Harmony Cloud Studio proporciona una interfaz para ingresar información proporcionada por el usuario, como las credenciales del servidor, para crear una conexión de base de datos. Esa conexión proporciona la base para configurar las actividades asociadas del conector de base de datos que interactúan con la conexión. En conjunto, una conexión de base de datos específica y sus actividades se denominan extremo de base de datos.

Descripción General del Conector¶

Este conector se utiliza primero para configurar una conexión de base de datos, estableciendo acceso a una base de datos, y luego se usa para configurar una o más actividades de la base de datos asociadas con esa conexión como origen o destino dentro de una operación o secuencia de comandos:

• Consulta: Consulta datos desde un extremo de la base de datos y está diseñado para usarse como fuente en una operación o llamarse en un secuencia de comandos.
• Insertar: Inserta datos nuevos en un extremo de la base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos.
• Actualizar: Actualiza los datos existentes en un extremo de la base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos.
• Actualizar: Actualiza los datos existentes e inserta datos nuevos en un extremo de la 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 de Upsert para bases de datos mediante el uso de una combinación de Consulta, Insertar y Actualizar).

Accediendo al Conector¶

Se accede al conector de base de datos desde la pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).

Bases de Datos y Datos Compatibles¶

Se admiten la mayoría de las bases de datos compatibles con JDBC y ODBC.

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 TLS Compatibles¶

Transport Layer Security (TLS) 1.2 es compatible y recomendado para extremos de bases de datos JDBC. TLS 1.0 y 1.1 ya no son compatibles con los Agentes en Nube y están deshabilitados de forma predeterminada en los Agentes Privados versión 10.47 y posteriores.

Si un extremo de base de datos ya no funciona después de una actualización a un agente 10.47 o posterior, agregue enabledTLSProtocols=TLSv1.2 a la cadena de conexión de la base de datos durante la configuración de la Conexión de la base de datos para forzar el uso de TLS 1.2 (siempre que la versión del protocolo sea compatible con el extremo de la base de datos).

En los Agentes Privados, si el extremo de la base de datos no admite TLS 1.2, 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

Instalación de Controladores JDBC U ODBC Adicionales¶

Los controladores de la base de datos se detectan automáticamente desde Harmony Agente. Para los Agentes en Nube, administrados por Jitterbit, se admite y ya se proporciona un conjunto de controladores JDBC de uso común. Para los Agentes Privados, los controladores instalados se detectan desde el sistema operativo donde está instalado cada Agente Privado. Además, puede instalar otros controladores de bases de datos en Agentes Privados según sea necesario. Si necesita el uso de un controlador ODBC, puede utilizar un Agente Privado de Windows.

Para obtener información general e instrucciones sobre cómo instalar controladores adicionales en Agentes Privados, consulte Instalación de controladores ODBC o JDBC adicionales.

Caracteres Especiales en Nombres de Tablas/columnas de Bases de Datos¶

Si utiliza un Agente Privado, puede especificar los 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 la [DbDrivers] sección.

Si utiliza un controlador de base de datos ODBC, tenga en cuenta que el controlador no puede manejar algunos caracteres especiales en los nombres de tablas/columnas de la base de datos. Por ejemplo, los campos de la 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 usa dichos 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 usarlo en su lugar.

Información Específica de la Base de Datos¶

Consulte Información específica de la base de datos para obtener información de referencia sobre la configuración de estas bases de datos:

• IBM DB2 (AS400)
• Microsoft Access
• Microsoft Excel
• SQL Server
• MySQL
• Oracle
• PostgreSQL
• Progreso

Funciones de Base de Datos¶

Se pueden utilizar varias funciones de base de datos dentro de secuencias de comandos para proporcionar acceso a interacciones básicas de bases de datos, incluidas 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.

Solución de Problemas¶

Si tiene problemas con el conector de la base de datos, se recomiendan estos pasos de solución de problemas:

1. Asegúrese de que la Conexión de base de datos se realiza correctamente utilizando el botón Probar en la pantalla de configuración. Si la conexión no se realiza correctamente, el error devuelto puede proporcionar una indicación del problema.

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

3. Habilite el registro de depurar de operación (para Agentes en Nube o para Agentes Privados) para generar archivos de registro y datos adicionales.

4. Si utiliza Agentes Privados, puede consultar los registros de agentes para más información.