Conectar ao Oracle usando o conector de banco de dados no Jitterbit Studio

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

É possível conectar a um banco de dados Oracle usando um driver JDBC ou ODBC. O driver JDBC do Oracle é incluído com agentes na nuvem e agentes privados. O driver JDBC é recomendado para recursos adicionais, como a capacidade de fornecer uma consulta manual, que não estão disponíveis através de uma conexão ODBC. Esta seção descreve como configurar um banco de dados Oracle no Studio usando um driver ODBC em agentes privados.

Instalar o cliente Oracle no agente privado Jitterbit

Antes de estabelecer uma conexão com o Oracle através de ODBC, é necessário ter o Cliente Oracle (incluindo o driver ODBC do Oracle) instalado no agente privado Jitterbit. Se estiver usando múltiplos agentes privados em um grupo de agentes, o Cliente Oracle deve ser instalado em todos os agentes do grupo. Consulte Agentes para obter detalhes.

Configurar e testar o cliente Oracle

Após instalar o Cliente Oracle, configure o arquivo tnsnames.ora para referenciar o banco de dados que pretende usar. Isso faz parte do procedimento padrão de configuração do Cliente Oracle. Para obter informações adicionais, consulte Tnsnames.org - Oracle FAQ ou a documentação do Oracle para a versão que está usando.

Após configurar o Cliente Oracle no agente privado, teste o servidor para garantir que o Harmony tenha conectividade com o banco de dados. Uma forma de fazer isso é conectar ao servidor através do SQL*Plus. Se isso for bem-sucedido, o Cliente Oracle deve funcionar corretamente com o Harmony.

Além disso, algumas versões do driver Oracle (não o driver Oracle da Microsoft) podem exigir que uma ou mais variáveis de ambiente 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, também pode ser necessário adicionar o diretório da biblioteca Oracle ao caminho (por exemplo, LD_LIBRARY_PATH). Adicione essas variáveis ao arquivo /etc/sysconfig/jitterbit. Alguns exemplos são mostrados abaixo, mas o caminho exato depende da instalação do Cliente 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 a conexão de banco de dados

Após configurar e testar o Cliente Oracle, especifique essas entradas durante a configuração da conexão de banco de dados:

Tipo de Driver: Selecione ODBC.
Driver: Selecione o driver Oracle. Se não visualizar o driver na lista, consulte Adicionar o driver ao arquivo de configuração do agente Jitterbit abaixo.
Usar String de Conexão: Em Configurações Opcionais, marque esta caixa de seleção. É necessário construir a string de conexão manualmente, pois o Oracle referencia o banco de dados com base na configuração em tnsnames.ora.
String de Conexão: Em Configurações Opcionais, insira a string de conexão manual para o 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 do Oracle estão disponíveis em The Connection Strings Reference.

Adicionar o driver ao arquivo de configuração do agente privado

Devido às muitas variações no nome do driver Oracle, você pode precisar adicionar as informações do seu driver ao arquivo de configuração do agente privado.

Após adicionar as informações do driver conforme descrito abaixo, ao selecionar seu driver no Studio, ele deverá aparecer na lista de drivers ODBC. Se as etapas abaixo não forem bem-sucedidas, consulte Instalar drivers ODBC ou JDBC adicionais para detalhes sobre a instalação do driver.

Configuração do agente remoto

Se você tiver a configuração do agente remoto ativada através do Console de Gerenciamento, poderá adicionar as informações do seu driver na aba Db Drivers conforme segue. Para detalhes sobre a configuração do agente remoto, consulte a seção sobre Agentes em Agentes.

No Console de Gerenciamento, acesse Agentes > Grupos de Agentes.
Na tabela, localize 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 e clique em Editar no canto superior direito. Localize a seguinte entrada de exemplo para uma versão específica do Oracle e substitua as informações de exemplo fornecidas pelas informações do seu driver ODBC Oracle específico. Quando concluído, clique em Enviar 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 interrompa os serviços e depois reinicie-os. Consulte Reiniciar um agente privado 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 na seção [DbDrivers] do arquivo jitterbit.conf localizado em cada agente privado. Para detalhes, consulte Editar o arquivo de configuração (jitterbit.conf).

Abra jitterbit.conf em um editor de texto e role até a seção [DbDrivers].
Localize a seguinte entrada de exemplo para uma versão específica do Oracle e substitua as informações de exemplo fornecidas pelas informações do seu driver ODBC Oracle específico. Quando concluído, salve o arquivo jitterbit.conf.
```
#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 interrompa os serviços e depois reinicie-os. Consulte Reiniciar um agente privado Windows ou Reiniciar um agente privado Linux para mais informações.

Exemplos de cláusula WHERE

Estes exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consulta 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 exemplos adicionais, consulte Oracle Basics e o artigo Oracle WHERE clause.