Saltar al contenido

Instale Controladores ODBC o JDBC Adicionales

Introducción

Jitterbit proporciona controladores de bases de datos de uso común, ya sea incluidos con 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: Para 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 en Nube.

Esta página enumera los controladores proporcionados y describe los pasos genéricos para instalar controladores adicionales en un Agente Privado.

Controladores Proporcionados por Agentes Privados

Estos controladores JDBC los proporcionan 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 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

Nota

Los controladores solo para Agentes Privados de 64 bits se enumeran arriba, ya que los Agentes Privados de 32 bits tienen fin de 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 Cloud Studio Información específica de la base de datos o Design Studio Base de datos.

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

  1. Obtenga el archivo JAR del controlador. En muchos casos, estos 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.

  2. 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 ubicarse 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/.

  3. Para Agentes Privados de Linux, establezca la propiedad del archivo copiado:

    sudo chown jitterbit:jitterbit <JITTERBIT_HOME>/tomcat/drivers/lib/*.jar

  4. Ubique 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. Cambiar el nombre interrumpirá los proyectos existentes que utilizan este controlador. Para recuperar, todos los extremos de la base de datos que usan este controlador deben actualizarse; para ello, vuelva a seleccionar el controlador con el nuevo nombre y luego vuelva a desplegarlo.
    <Class> El nombre completo de la clase de controlador. Consulte la documentación del controlador en particular.
    <Subprotocol> El subprotocolo que se utilizará al construir la URL para conectarse a una base de datos utilizando el controlador. La URL tiene la forma 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> Defina su propio carácter de "comilla inicial" (rara vez es necesario).
    <EndQuote> Defina su propio carácter de "comilla final" (rara vez es necesario).

    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>

  5. 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 Jitterbit Services
    Iniciar Jitterbit Services

    Desde el directorio de instalación del Jitterbit Agente:

    > StopServices.bat
    > StartServices.bat

    Desde un mensaje:

    $ sudo jitterbit stop
    $ sudo jitterbit start

  6. Pruebe dentro de la aplicación de administración JDBC para garantizar la conectividad entre el controlador y la fuente de datos subyacente.

  7. Una vez instalado correctamente, el controlador adicional se detecta 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:

    Nota

    Es posible que necesite 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 sobre cómo se debe estructurar la cadena de conexión. Para obtener información adicional sobre bases de datos seleccionadas, consulte Cloud Studio Información específica de la base de datos o Design Studio Base de datos.