Configurar una fuente de base de datos ODBC de Oracle en Jitterbit Design Studio

Esta página describe cómo configurar una base de datos Oracle como fuente o destino dentro de Jitterbit Studio utilizando un controlador ODBC. Consulta Base de datos para obtener información sobre los tipos de autenticación admitidos para varios sistemas.

Nota

También puedes conectarte a una base de datos Oracle utilizando un controlador JDBC. Se recomienda el controlador JDBC para funciones adicionales, como la creación manual de scripts SQL, que no están disponibles a través de una conexión ODBC.

Instalar el cliente de Oracle en el agente privado de Jitterbit

Antes de poder establecer una conexión con Oracle a través de ODBC, debes tener instalado el Cliente de Oracle (incluido el controlador ODBC de Oracle) en tu agente privado de Jitterbit. Si estás utilizando múltiples agentes privados dentro de un grupo de agentes, el Cliente de Oracle debe estar instalado en todos los agentes del grupo. Consulta Agentes para más información.

Configurar y probar el cliente de Oracle

Una vez que hayas instalado el Cliente de Oracle, configura el archivo TNSNames.ora para hacer referencia a la base de datos que planeas utilizar. Esto es parte del procedimiento estándar de configuración del Cliente de Oracle. Para obtener información adicional, consulta Tnsnames.org - Oracle FAQ o consulta la documentación de Oracle para la versión que estás utilizando.

Después de que el Cliente de Oracle esté configurado en el agente de Jitterbit, debes probar el servidor para asegurarte de que Jitterbit tenga conectividad con la base de datos. Una forma de hacerlo es conectarse al servidor a través de SQL*Plus. Si esto tiene éxito, el Cliente de Oracle debería funcionar correctamente con Jitterbit.

Además, algunas versiones del controlador de Oracle (no el controlador de Oracle de Microsoft) pueden requerir que se establezca una o más de las siguientes variables de entorno dentro del sistema operativo. Por ejemplo:

ORACLE_HOME=/usr/local/oracle/10.2.0
TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
TWO_TASK=//dbdpmr:1555/pmrd1

En Linux, también puede ser necesario agregar el directorio de la biblioteca de Oracle a su ruta (por ejemplo, LD_LIBRARY_PATH). Agregue esto al archivo /etc/sysconfig/jitterbit. A continuación se muestran algunos ejemplos, pero la ruta exacta dependerá de su instalación del Cliente de Oracle.

LD_LIBRARY_PATH=/usr/local/oracle/lib
export ORACLE_HOME=/usr/local/oracle/10.2.0
export TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
export TWO_TASK=//dbdpmr:1555/pmrd1

Configurar la conexión de Oracle en Jitterbit Studio

Siga los pasos a continuación para configurar su conexión de Oracle como fuente o destino en Jitterbit Studio.

Vaya a Jitterbit Studio y configure su fuente o destino como de costumbre, eligiendo Base de datos como tipo.
Seleccione su Controlador haciendo clic en el botón Seleccionar para mostrar un aviso para seleccionar los controladores disponibles. En el aviso, asegúrese de que la casilla para ODBC esté marcada, luego seleccione su controlador de la lista y haga clic en Aceptar. Si no ve su controlador en la lista, consulte Agregue su controlador al archivo de configuración del agente Jitterbit a continuación.
Haga clic en Opciones para expandir configuraciones adicionales.
1. Marque la casilla para Construir la cadena de conexión manualmente, ya que Oracle hace referencia a la base de datos según la configuración en TNSNames.ora.
2. Ingrese una cadena de conexión manual para su base de datos Oracle específica. Por ejemplo:
  Oracle en OraHome92
```
Driver={Oracle en OraHome92};Dbq=myTNSServiceName;Uid=myUsername;Pwd=myPassword;
```
  Oracle en OraClient11g_home1
```
DRIVER={Oracle en OraClient11g_home1};SERVER=[server SID];UID=[userid];
PWD=[password];DBQ=[server SID];
```
  Consejo
  
  Ejemplos adicionales de cadenas de conexión de Oracle están disponibles en La referencia de cadenas de conexión.

Agregue su controlador al archivo de configuración del agente Jitterbit

Debido a las muchas variaciones en el nombre del controlador de Oracle, es posible que deba agregar la información de su controlador al archivo de configuración de Jitterbit.

Una vez que la información del controlador se haya agregado como se describe a continuación, dentro de Jitterbit Studio al seleccionar su controlador, haga clic en el botón Actualizar y debería ver su controlador aparecer en la lista de controladores ODBC. Si los pasos a continuación no tienen éxito, también puede consultar Instalar controladores ODBC o JDBC adicionales para obtener instrucciones más detalladas sobre la instalación del controlador.

Configuración del agente remoto

Si tienes habilitada la configuración del agente remoto a través de la Consola de Administración, puedes agregar la información de tu controlador de la siguiente manera.

Dentro de la Consola de Administración, ve a Agentes.
Encuentra tu grupo de agentes y selecciona Configuración de Jitterbit.
En la pestaña Controladores de Base de Datos, haz clic en Editar. Encuentra el siguiente ejemplo de entrada para una versión específica de Oracle y reemplaza la información de muestra proporcionada con la de tu controlador ODBC de Oracle específico. Cuando termines, haz clic en Guardar para guardar la información del controlador en el archivo de configuración del agente Jitterbit.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```

Todos los servicios de Jitterbit deben reiniciarse para que la nueva configuración tenga efecto.

En la máquina donde está instalado cada agente privado, primero detén los servicios y luego reinícialos.

Windows Linux

Desde el Menú de Inicio:

Detener Servicios de Jitterbit
Iniciar Servicios de Jitterbit

Desde el directorio de instalación del agente Jitterbit:

> StopServices.bat
> StartServices.bat

Desde un terminal:

$ sudo jitterbit stop
$ sudo jitterbit start

Configuración manual del agente

Si estás utilizando la configuración manual del agente, puedes agregar la información de tu controlador en la sección [Dbdrivers] del archivo jitterbit.conf ubicado en cada agente privado. Para más información, consulta Editar el archivo de configuración (jitterbit.conf).

Abre jitterbit.conf en un editor de texto y desplázate a la sección [DbDrivers].
Encuentra la siguiente entrada de ejemplo para una versión específica de Oracle y reemplaza la información de muestra proporcionada con la de tu controlador ODBC de Oracle específico. Cuando termines, guarda el archivo jitterbit.conf.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```