Conectar a Oracle usando el conector de Base de datos en Jitterbit Studio

Esta página detalla cómo conectar a base de datos Oracle usando el conector de Base de datos.

Se puede conectar a una base de datos Oracle usando un controlador JDBC u ODBC. El controlador JDBC de Oracle viene incluido con agentes en la nube y agentes privados. Se recomienda el controlador JDBC para funciones adicionales, como la capacidad de proporcionar una consulta manual, que no están disponibles a través de una conexión ODBC. Esta sección describe cómo configurar una base de datos Oracle en Studio usando un controlador ODBC en agentes privados.

Instalar el cliente de Oracle en el agente privado de Jitterbit

Antes de poder establecer una conexión a Oracle a través de ODBC, se debe tener el Cliente de Oracle (incluido el controlador ODBC de Oracle) instalado en el agente privado de Jitterbit. Si se utilizan 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 obtener más detalles.

Configurar y probar el cliente de Oracle

Después de instalar el Cliente de Oracle, configura el archivo tnsnames.ora para hacer referencia a la base de datos que planeas usar. 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 la documentación de Oracle para la versión que estés usando.

Después de configurar el Cliente de Oracle en el agente privado, se debe probar el servidor para asegurar que Harmony tenga conectividad con la base de datos. Una forma de hacerlo es conectarse al servidor a través de SQL*Plus. Si esto es exitoso, el Cliente de Oracle debería funcionar correctamente con Harmony.

Además, algunas versiones del controlador de Oracle (no el controlador Oracle de Microsoft) pueden requerir que se establezcan una o más 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 bibliotecas de Oracle a tu ruta (por ejemplo, LD_LIBRARY_PATH). Agrega estos al archivo /etc/sysconfig/jitterbit. A continuación se muestran algunos ejemplos, pero la ruta exacta depende de tu 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 Base de datos

Después de configurar y probar el Cliente de Oracle, especifica estas entradas durante la configuración de la conexión de Base de datos:

Tipo de controlador: Selecciona ODBC.
Controlador: Selecciona el controlador de Oracle. Si no ves tu controlador en la lista, consulta Agregar tu controlador al archivo de configuración del agente de Jitterbit a continuación.
Usar cadena de conexión: En Configuración opcional, marca esta casilla. Se debe 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.
Cadena de conexión: En Configuración opcional, ingresa la cadena de conexión manual para tu base de datos Oracle específica. Por ejemplo:
Oracle in OraHome92
```
Driver={Oracle in OraHome92};Dbq=myTNSServiceName;Uid=myUsername;Pwd=myPassword;
```
Oracle in OraClient11g_home1
```
DRIVER={Oracle in OraClient11g_home1};SERVER=[server SID];UID=[userid];
PWD=[password];DBQ=[server SID];
```
Consejo

Hay ejemplos adicionales de cadenas de conexión de Oracle disponibles en The Connection Strings Reference.

Agregar tu controlador al archivo de configuración del agente privado

Debido a las muchas variaciones en el nombre del controlador de Oracle, es posible que necesites agregar la información de tu controlador al archivo de configuración del agente privado.

Una vez que agregues la información del controlador como se describe a continuación, al seleccionar tu controlador en Studio deberías ver que tu controlador aparece en la lista de controladores ODBC. Si los pasos a continuación no tienen éxito, consulta Instalar controladores ODBC o JDBC adicionales para obtener detalles sobre la instalación de controladores.

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 en la pestaña Db Drivers de la siguiente manera. Para obtener detalles sobre la configuración del agente remoto, consulta la sección sobre Agentes en Agentes.

En la Consola de administración, ve a Agentes > Grupos de agentes.
En la tabla, busca tu grupo de agentes y utiliza el menú desplegable Acción para seleccionar Jitterbit Conf.
En el diálogo, selecciona la pestaña Db Drivers, luego haz clic en Editar en la esquina superior derecha. Busca la siguiente entrada de ejemplo para una versión específica de Oracle y reemplaza la información de ejemplo proporcionada con la de tu controlador ODBC de Oracle específico. Cuando termines, haz clic en Enviar para guardar la información del controlador en el archivo de configuración del agente privado.
```
#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 surta efecto.

En la máquina donde está instalado cada agente privado, primero detén los servicios y luego reinícialos. Consulta Reiniciar un agente privado de Windows o Reiniciar un agente privado de Linux para obtener más información.

Configuración manual del agente

Si utilizas 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 obtener detalles, consulta Editar el archivo de configuración (jitterbit.conf).

Abre jitterbit.conf en un editor de texto y desplázate hasta la sección [DbDrivers].
Busca la siguiente entrada de ejemplo para una versión específica de Oracle y reemplaza la información de ejemplo 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'='\"'
```
Todos los servicios de Jitterbit deben reiniciarse para que la nueva configuración surta efecto.

En la máquina donde está instalado cada agente privado, primero detén los servicios y luego reinícialos. Consulta Reiniciar un agente privado de Windows o Reiniciar un agente privado de Linux para obtener más información.

Ejemplos de cláusula WHERE

Estos ejemplos de cláusula WHERE se proporcionan como referencia al configurar una Actividad de consulta de base de datos:

WHERE
    product_name = 'Kingston';

WHERE
    list_price > 500;

WHERE
    list_price > 500
    AND category_id = 4;

WHERE
    list_price BETWEEN 650 AND 680

WHERE
    category_id IN(1, 4)

WHERE
    product_name LIKE 'Asus%'

WHERE business_seats_taken IS NULL
    OR business_seats_taken = 0

WHERE EMP_ACT.EMPNO = EMPLOYEE.EMPNO

WHERE THIS_EMP.JOB = 'SALESREP'
       AND THIS_EMP.WORKDEPT = DINFO.DEPTNO

Para obtener ejemplos adicionales, consulta Oracle Basics y el artículo de Oracle WHERE clause.