Conecte-se ao Oracle usando o conector de banco de dados no Jitterbit Integration Studio

Esta página detalha como se conectar ao banco de dados Oracle usando o conector de banco de dados.

Você pode se conectar a um banco de dados Oracle usando um driver JDBC ou ODBC. Versão 19.7 do driver JDBC da Oracle está incluído com nuvem e agentes privados. O driver JDBC é recomendado para recursos adicionais, como a capacidade de fornecer uma consultar manual, que não estão disponíveis por meio de uma conexão ODBC. Esta seção descreve como configurar um banco de dados Oracle dentro do Integration Studio usando um driver ODBC em agentes privados.

Instale o cliente Oracle no agente privado Jitterbit

Antes de poder estabelecer uma conexão com o Oracle por meio do ODBC, você deve ter o Oracle Client (incluindo o driver Oracle ODBC) instalado no agente privado Jitterbit. Se você estiver usando vários agentes privados dentro de um grupo de agentes, o Oracle Client deve ser instalado em todos os agentes do grupo. Consulte Agentes para detalhes.

Configurar e testar o cliente Oracle

Depois de instalar o Oracle Client, configure o tnsnames.ora arquivo para referenciar o banco de dados que você está planejando usar. Isso faz parte do procedimento padrão de configuração do Oracle Client. Para obter informações adicionais, consulte Tnsnames.org - Oracle perguntas frequentes ou consulte a documentação do Oracle para a versão que você está usando.

Após o Oracle Client ser configurado no agente privado, você deve testar o servidor para garantir que o Harmony tenha conectividade com o banco de dados. Uma maneira de fazer isso é conectar-se ao servidor por meio do SQL*Plus. Se isso for bem-sucedido, o Oracle Client deve operar corretamente com o Harmony.

Além disso, algumas versões do driver Oracle (não o driver Microsoft Oracle) podem exigir que uma ou mais variáveis de ambiente dentro do sistema operacional sejam definidas. Por exemplo:

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

No Linux, você também pode precisar adicionar o diretório da biblioteca Oracle ao seu caminho (por exemplo LD_LIBRARY_PATH). Adicione-os ao /etc/sysconfig/jitterbit arquivo. Alguns exemplos são mostrados abaixo, mas o caminho exato depende da instalação do seu Oracle Client:

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 a conexão com o banco de dados

Após o Oracle Client ser configurado e testado, especifique essas entradas durante a configuração da conexão do banco de dados:

Tipo de driver: Selecione ODBC.
Driver: Selecione o driver Oracle. Se você não vir seu driver na lista, consulte Adicione seu driver ao arquivo de configuração do agente Jitterbit abaixo.
Usar String de Conexão: Em Optional Settings, selecione esta caixa de seleção. Você deve construir a string de conexão manualmente, pois o Oracle faz referência ao banco de dados com base na configuração em tnsnames.ora.
String de conexão: Em Optional Settings, insira a string de conexão manual para seu banco de dados Oracle específico. Por exemplo:
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];
```
Dica

Exemplos adicionais de strings de conexão Oracle estão disponíveis em The Connection Strings Reference.

Adicione seu driver ao arquivo de configuração do agente privado

Devido às muitas variações no nome do driver Oracle, talvez seja necessário adicionar as informações do driver ao arquivo de configuração do agente privado.

Depois que as informações do driver forem adicionadas conforme descrito abaixo, ao selecionar seu driver no Integration Studio, você deverá ver seu driver aparecer na lista de drivers ODBC. Se as etapas abaixo não forem bem-sucedidas, consulte Instalar drivers ODBC ou JDBC adicionais para obter detalhes sobre a instalação do driver.

Configuração do agente remoto

Se você tiver a configuração do agente remoto habilitada por meio do Management Console, você pode adicionar suas informações de driver na aba Db Drivers como segue. Para detalhes sobre a configuração do agente remoto, veja a seção sobre Agentes em Agentes.

Dentro do Management Console, vá para Agentes > Grupos de Agente.
Na tabela, encontre seu grupo de agentes e use o menu suspenso Ação para selecionar Jitterbit Conf.
Na caixa de diálogo, selecione a aba Db Drivers, então clique em Edit no canto superior direito. Encontre a seguinte entrada de exemplo para uma versão específica do Oracle, e substitua as informações de exemplo fornecidas pelas do seu driver ODBC Oracle específico. Quando terminar, clique em Submit para salvar as informações do driver no arquivo de configuração do agente privado.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```
Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

Na máquina onde cada agente privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um agente privado do Windows ou Reiniciar um agente privado Linux para mais informações.

Configuração manual do agente

Se você estiver usando a configuração manual do agente, poderá adicionar as informações do seu driver em [DbDrivers] seção do jitterbit.conf arquivo localizado em cada agente privado. Para obter detalhes, consulte Editar o arquivo de configuração (jitterbit.conf).

Abrir jitterbit.conf em um editor de texto e role até o [DbDrivers] seção.
Encontre a seguinte entrada de exemplo para uma versão específica do Oracle e substitua as informações de amostra fornecidas pelas do seu driver ODBC Oracle específico. Quando concluído, salve o jitterbit.conf arquivo.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```
Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

Na máquina onde cada agente privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um agente privado do Windows ou Reiniciar um agente privado Linux para mais informações.

Exemplos de cláusula WHERE

Esses exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consultar de banco de dados:

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 obter exemplos adicionais, consulte Oracle Basics e o artigo Oracle cláusula WHERE.