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

Esta página detalla cómo conectarse a la base de datos de Oracle utilizando el conector de Base de Datos.

Se puede conectar a una base de datos de Oracle utilizando un controlador JDBC o ODBC. La versión 19.7 del controlador JDBC de Oracle está incluida con agentes en la nube y agentes privados. Se recomienda el controlador JDBC por características 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 de Oracle dentro de Studio utilizando 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, debe tener instalado el Cliente de Oracle (incluido el controlador ODBC de Oracle) en el agente privado de Jitterbit. Si está utilizando múltiples agentes privados dentro de un grupo de agentes, el Cliente de Oracle debe estar instalado en todos los agentes del grupo. Consulte Agentes para más detalles.

Configurar y probar el cliente de Oracle

Después de haber instalado el Cliente de Oracle, configure el archivo tnsnames.ora para hacer referencia a la base de datos que planea utilizar. Esto es parte del procedimiento estándar de configuración del Cliente de Oracle. Para información adicional, consulte el Tnsnames.org - Preguntas Frecuentes de Oracle o consulte la documentación de Oracle para la versión que está utilizando.

Después de que el Cliente de Oracle esté configurado en el agente privado, debe probar el servidor para asegurarse de 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 tiene éxito, el Cliente de Oracle debería funcionar correctamente con Harmony.

Además, algunas versiones del controlador de Oracle (no el controlador de 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 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 depende 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

Configure la conexión a la base de datos

Después de que el Cliente de Oracle esté configurado y probado, especifique estas entradas durante la configuración de la conexión a la base de datos:

Tipo de controlador: Seleccione ODBC.
Controlador: Seleccione el controlador de Oracle. Si no ve su controlador en la lista, consulte Agregue su controlador al archivo de configuración del agente de Jitterbit a continuación.
Usar cadena de conexión: En Configuraciones opcionales, seleccione esta casilla. 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 Configuraciones opcionales, ingrese la 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 privado

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 del agente privado.

Una vez que la información del controlador se haya agregado como se describe a continuación, al seleccionar su controlador dentro de Studio, debería ver su controlador aparecer en la lista de controladores ODBC. Si los pasos a continuación no tienen éxito, consulte Instalar controladores ODBC o JDBC adicionales para obtener detalles sobre la instalación del controlador.

Configuración del agente remoto

Si tiene habilitada la configuración del agente remoto a través de la Consola de Administración, puede agregar la información de su controlador en la pestaña Db Drivers de la siguiente manera. Para obtener detalles sobre la configuración del agente remoto, consulte la sección sobre Agentes en Agentes.

Dentro de la Consola de Administración, vaya a Agentes > Grupos de Agentes.
Dentro de la tabla, encuentre su grupo de agentes y use el menú desplegable Acción para seleccionar Jitterbit Conf.
En el cuadro de diálogo, seleccione la pestaña Db Drivers, luego haga clic en Editar en la parte superior derecha. Encuentre la siguiente entrada de ejemplo para una versión específica de Oracle y reemplace la información de muestra proporcionada con la de su controlador ODBC de Oracle específico. Cuando haya terminado, haga 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 tenga efecto.

En la máquina donde está instalado cada agente privado, primero detenga los servicios y luego reinícielos. Consulte 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 está utilizando la configuración manual del agente, puede agregar la información de su controlador en la sección [DbDrivers] del archivo jitterbit.conf ubicado en cada agente privado. Para obtener detalles, consulte 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'='\"'
```
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. Consulta Reiniciar un agente privado de Windows o Reiniciar un agente privado de Linux para más información.

Ejemplos de cláusula WHERE

Estos ejemplos de cláusula WHERE se proporcionan con fines de 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 ejemplos adicionales, consulta Conceptos básicos de Oracle y el artículo de Oracle cláusula WHERE.