Conectar ao Oracle usando o conector de Banco de Dados no Jitterbit Studio

Esta página detalha como conectar-se 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. A versão 19.7 do driver JDBC da Oracle está incluída com agentes em 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 dentro do 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 do ODBC, você deve ter o Cliente Oracle (incluindo o driver ODBC da Oracle) instalado no agente privado Jitterbit. Se você estiver usando vários agentes privados dentro de um grupo de agentes, o Cliente Oracle deve ser instalado em todos os agentes do grupo. Consulte Agentes para mais 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 você planeja usar. Esta é parte do procedimento padrão de configuração do Cliente Oracle. Para informações adicionais, consulte o Tnsnames.org - FAQ da Oracle ou consulte a documentação da Oracle para a versão que você está usando.

Depois que o Cliente Oracle estiver 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 através do SQL*Plus. Se isso for bem-sucedido, o Cliente Oracle deve operar 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 dentro do sistema operacional sejam configuradas. 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 isso ao arquivo /etc/sysconfig/jitterbit. Alguns exemplos são mostrados abaixo, mas o caminho exato depende da sua instalação do 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 a configuração e teste do Oracle Client, especifique essas entradas durante a configuração da Conexão com o banco de dados:

Tipo de Driver: Selecione ODBC.
Driver: Selecione o driver Oracle. Se você não ver seu driver na lista, consulte Adicione seu driver ao arquivo de configuração do agente Jitterbit abaixo.
Usar String de Conexão: Em Configurações Opcionais, selecione esta caixa de seleção. Você deve 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 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 A Referência de Strings de Conexão.

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

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

Uma vez que as informações do driver sejam adicionadas conforme descrito abaixo, ao selecionar seu driver dentro do Studio, você deve ver seu driver aparecer na lista de drivers ODBC. Se os passos abaixo não forem bem-sucedidos, 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 habilitada através do Console de Gerenciamento, pode adicionar suas informações de driver na aba Db Drivers da seguinte forma. Para detalhes sobre a configuração do agente remoto, consulte a seção sobre Agentes em Agentes.

Dentro do Console de Gerenciamento, vá para Agentes > Grupos de Agentes.
Dentro da tabela, encontre seu grupo de agentes e use o dropdown Ação para selecionar Jitterbit Conf.
Na caixa de diálogo, selecione a aba Db Drivers, em seguida clique em Editar 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 informações do seu driver ODBC Oracle específico. Quando terminar, 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 tenha efeito.

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

Configuração manual do agente

Se você estiver usando a configuração manual do agente, pode adicionar suas informações de 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].
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, 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 do Jitterbit devem ser reiniciados para que a nova configuração tenha efeito.

Na máquina onde cada agente privado está instalado, primeiro pare os serviços e, em seguida, reinicie-os. Consulte Reiniciar um agente privado do Windows ou Reiniciar um agente privado do 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 Fundamentos do Oracle e o artigo do Oracle Cláusula WHERE.