Configurar uma fonte de banco de dados Oracle ODBC no Jitterbit Design Studio

Esta página descreve como configurar um banco de dados Oracle como fonte ou destino dentro do Jitterbit Studio usando um driver ODBC. Veja Banco de Dados para informações sobre os tipos de autenticação suportados para vários sistemas.

Nota

Você também pode se conectar a um banco de dados Oracle usando um driver JDBC. O driver JDBC é recomendado para recursos adicionais, como a criação manual de scripts SQL, que não estão disponíveis via uma conexão ODBC.

Instalar o cliente Oracle no agente privado do Jitterbit

Antes de estabelecer uma conexão com o Oracle via ODBC, você deve ter o Cliente Oracle (incluindo o driver ODBC Oracle) instalado no seu agente privado do 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. Veja Agentes para mais informações.

Configurar e testar o cliente Oracle

Uma vez que você tenha instalado o Cliente Oracle, configure o arquivo TNSNames.ora para referenciar o banco de dados que você planeja usar. Isso faz parte do procedimento padrão de configuração do Cliente Oracle. Para informações adicionais, veja Tnsnames.org - Oracle FAQ ou consulte a documentação do Oracle para a versão que você está usando.

Após a configuração do Cliente Oracle no agente Jitterbit, você deve testar o servidor para garantir que o Jitterbit tenha conectividade com o banco de dados. Uma maneira de fazer isso é conectar-se ao servidor via SQL*Plus. Se isso for bem-sucedido, o Cliente Oracle deve operar corretamente com o Jitterbit.

Além disso, algumas versões do driver Oracle (não o driver Oracle da Microsoft) podem exigir uma ou mais das seguintes variáveis de ambiente dentro do sistema operacional para serem 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 isso ao arquivo /etc/sysconfig/jitterbit. Alguns exemplos são mostrados abaixo, mas o caminho exato dependerá 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 Oracle no Jitterbit Studio

Siga os passos abaixo para configurar sua conexão Oracle como fonte ou destino no Jitterbit Studio.

Vá para o Jitterbit Studio e configure sua fonte ou destino normalmente, escolhendo Banco de Dados como o tipo.
Selecione seu Driver clicando no botão Selecionar para exibir um prompt para selecionar drivers disponíveis. No prompt, certifique-se de que a caixa de seleção para ODBC esteja marcada, em seguida, selecione seu driver na lista e clique em OK. Se você não ver seu driver na lista, consulte Adicione seu driver ao arquivo de configuração do agente Jitterbit abaixo.
Clique em Opções para expandir configurações adicionais.
1. Marque a caixa para Construir string de conexão manualmente, pois o Oracle referencia o banco de dados com base na configuração em TNSNames.ora.
2. Insira uma 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 Jitterbit

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 Jitterbit.

Uma vez que as informações do driver sejam adicionadas conforme descrito abaixo, dentro do Jitterbit Studio, ao selecionar seu driver, clique no botão Atualizar e você deverá ver seu driver aparecer na lista de drivers ODBC. Se os passos abaixo não forem bem-sucedidos, você também pode consultar Instalar drivers ODBC ou JDBC adicionais para obter instruções mais detalhadas 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 as informações do seu driver da seguinte forma.

No Console de Gerenciamento, vá para Agentes.
Encontre seu grupo de agentes e selecione Configuração do Jitterbit.
Na aba Drivers de Banco de Dados, clique em Editar. 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 Salvar para salvar as informações do driver no arquivo de configuração do agente Jitterbit.
```
#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.

Windows Linux

Do Menu Iniciar:

Parar Serviços do Jitterbit
Iniciar Serviços do Jitterbit

Do diretório de instalação do agente Jitterbit:

> StopServices.bat
> StartServices.bat

De um prompt:

$ sudo jitterbit stop
$ sudo jitterbit start

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 mais informações, consulte Editar o arquivo de configuração (jitterbit.conf).

Abra o 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'='\"'
```