Instalar controladores ODBC o JDBC adicionales en agentes privados de Jitterbit

Introducción

Jitterbit proporciona controladores de bases de datos de uso común, ya sea incluidos con el agente privado software, o detectado desde el sistema operativo del servidor en el que está instalado un agente privado.

Los controladores JDBC y ODBC adicionales solo se pueden instalar en agentes privados:

JDBC: Puede instalar controladores JDBC adicionales en cualquier agente privado, ya sea basado en Windows o Linux.
ODBC: En el caso de los controladores ODBC, la arquitectura del controlador debe coincidir con el sistema del agente. Los agentes admiten controladores ODBC de 64 bits.

No se pueden instalar controladores adicionales en agentes de la nube.

Esta página enumera los controladores proporcionados y describe los pasos genéricos para instalar controladores adicionales de un agente privado.

Conductores proporcionados por agentes privados

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 de Microsoft
SQLite
JTDS de Sybase

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

ANSI de PostgreSQL (x64)
Código Unicode PostgreSQL (x64)

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

PostgreSQL-jitterbit

Nota

Los controladores para agentes privados de 64 bits se enumeran arriba, ya que los agentes privados de 32 bits están al final de su vida útil.

Instalación de controladores en agentes privados

Al instalar controladores adicionales, consulte la documentación del controlador específico que está instalando. Para obtener información adicional sobre bases de datos seleccionadas, consulte Integration StudioInformación específica de la base de datos o Design Studio Base de datos.

A continuación se proporcionan los pasos genéricos para instalar controladores JDBC adicionales. Los controladores ODBC adicionales instalados en Windows no requieren ninguna configuración adicional.

Obtenga el archivo JAR del controlador. En muchos casos, estos archivos están disponibles para descargar desde el fabricante del controlador.

Por ejemplo, el controlador JDBC de SQL Server, incluidos sus archivos JAR disponibles, está disponible en Microsoft en Descargar el controlador JDBC de Microsoft para SQL Server.
Copie el archivo JAR en la siguiente ruta de carpeta recomendada: <JITTERBIT_HOME>/tomcat/drivers/lib/, reemplazando <JITTERBIT_HOME> con el directorio raíz del agente privado. El directorio raíz del agente privado suele estar en una de estas ubicaciones predeterminadas:
- Windows (Harmony): C:\Program Files\Jitterbit Agent\
- Linux: /opt/jitterbit
Precaución

Los archivos JAR también pueden estar ubicados en <JITTERBIT_HOME>/tomcat/webapps/axis/WEB-INF/lib/; sin embargo, este directorio puede sobrescribirse al actualizar un agente privado. En su lugar, recomendamos colocar los controladores que instale en <JITTERBIT_HOME>/tomcat/drivers/lib/.
Para los agentes privados de Linux, configure la propiedad del archivo copiado:
```
sudo chown jitterbit:jitterbit <JITTERBIT_HOME>/tomcat/drivers/lib/*.jar
```

Localice el JdbcDrivers.conf archivo en el directorio raíz del agente privado. Abra el archivo en modo administrador y agregue un nuevo <Driver> elemento en el <Drivers> sección con esta información y luego guarde el archivo:

Elemento	Descripción
`<Name>`	El nombre del controlador. Debe ser un nombre único. Este nombre aparecerá en la interfaz de usuario de selección de controlador. Si se cambia el nombre, se interrumpirán los proyectos existentes que utilicen este controlador. Para recuperarlo, todos los extremos de la base de datos que utilicen este controlador deben actualizarse volviendo a seleccionar el controlador con el nuevo nombre y, luego, volver a desplegarlo.
`<Class>`	El nombre completo de la clase del controlador. Consulte la documentación del controlador en particular.
`<Subprotocol>`	El subprotocolo que se debe utilizar al construir la URL para conectarse a una base de datos mediante el controlador. La URL tiene el formato `jdbc:subprotocol://...` Por ejemplo, un controlador PostgreSQL podría definir el subprotocolo `postgresql` Consulte la documentación del controlador para obtener más detalles.
`<BeginQuote>`	Define tu propio carácter de "comilla inicial" (raramente requerido).
`<EndQuote>`	Define tu propio carácter de "comillas finales" (raramente requerido).

Puedes encontrar ejemplos en el JdbcDrivers.conf archivo. Por ejemplo, el controlador JDBC de SQL Server utiliza esta información:

<Driver>
<Name>SQL Server</Name>
<Class>com.microsoft.sqlserver.jdbc.SQLServerDriver</Class>
<Subprotocol>sqlserver</Subprotocol>
</Driver>

En la máquina donde está instalado cada agente privado, primero detenga los servicios y luego reinícielos.

Windows Linux

Desde el menú Inicio:

Detener servicios Jitterbit
Iniciar servicios Jitterbit

Desde el directorio de instalación del Agente Jitterbit:

> StopServices.bat
> StartServices.bat

De un mensaje:

$ sudo jitterbit stop
$ sudo jitterbit start

Pruebe dentro de la aplicación de administración JDBC para garantizar la conectividad entre el controlador y la fuente de datos subyacente.
Una vez que se haya instalado correctamente, el controlador adicional se detectará desde el sistema operativo del servidor del agente. Ahora debería ver el controlador recién instalado dentro de la lista de controladores disponibles al configurar un extremo de base de datos:
- Integration Studio: En Integration Studio, el controlador aparece automáticamente al configurar una Conexión de base de datos.
- Design Studio: En Design Studio, el controlador debería aparecer automáticamente al configurar una Fuente de base de datos o objetivo. Si no es así, intente actualizar la pantalla de selección de controlador.
Nota

Es posible que deba configurar una cadena de conexión manual en la configuración del extremo de la base de datos. Consulte la documentación específica del controlador para saber cómo debe estructurarse la cadena de conexión. Para obtener información adicional sobre bases de datos seleccionadas, consulte Integration StudioInformación específica de la base de datos o Design Studio Base de datos.