Configurar uma Fonte de Banco de Dados Oracle ODBC¶

Esta página descreve como configurar um banco de dados Oracle como origem ou destino no Jitterbit Studio usando um driver ODBC. Consulte Banco de dados para obter informações sobre os tipos de autenticação suportados por 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 criação manual de scripts SQL, que não estão disponíveis por meio de uma conexão ODBC.

Instale o Oracle Client no Jitterbit Agente Privado¶

Antes de estabelecer uma conexão com o Oracle via ODBC, você deve ter o Oracle Client (incluindo o driver Oracle ODBC) instalado em seu Jitterbit Agente Privado. Se você estiver usando vários Agentes Privados em um Grupo de Agentes, o Oracle Client deverá ser instalado em todos os Agentes do grupo. Consulte Agentes > Agentes e Agentes > Grupos de Agente Para maiores informações.

Atualmente, o Jitterbit oferece suporte a drivers de 32 bits. Atualmente, o driver Oracle ODBC instalado em todos os Agentes no Grupo de Agentes deve ser de 32 bits. Se estiver usando um Oracle Client de 64 bits e um driver ODBC, você terá problemas para se conectar ao seu banco de dados Oracle. Para resolver esses problemas, instale a versão de 32 bits.

Configurar e Testar o Oracle Client¶

Depois de instalar o Oracle Client, configure o tnsnames.ora arquivo para fazer referência ao 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.

Depois que o Oracle Client estiver configurado no Jitterbit Agente, 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 for bem-sucedido, o Oracle Client deverá operar corretamente com o Jitterbit.

Além disso, algumas versões do driver Oracle (não o driver Microsoft Oracle ) podem exigir que uma ou mais das seguintes variáveis de ambiente no 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 dependerá da 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 o Oracle Connection no Jitterbit Studio¶

Siga as etapas abaixo para configurar sua conexão Oracle como origem ou destino no Jitterbit Studio.

Vá para o Jitterbit Studio e configure sua origem ou destino normalmente, escolhendo Database como o tipo.
Selecione seu Driver clicando no botão Selecionar para exibir um prompt para selecionar os drivers disponíveis. No prompt, verifique se a caixa de seleção ODBC está marcada, selecione seu driver na lista e clique em OK. Se você não vir seu driver na lista, consulte Adicionar seu driver ao arquivo de configuração do Jitterbit Agente abaixo.
Clique em Opções para expandir as configurações adicionais.
1. Marque a caixa Construir string de conexão manualmente, pois o Oracle faz referência ao banco de dados com base na configuração em tnsnames.ora.
2. Digite 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 driver ao arquivo de configuração do Jitterbit.

Depois que as informações do driver forem adicionadas conforme descrito abaixo, no Jitterbit Studio ao selecionar seu driver, clique no botão Atualizar e você verá seu driver aparecer na lista de drivers ODBC. Se as etapas abaixo não forem bem-sucedidas, 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 por meio do Management Console, você pode adicionar suas informações de driver na aba Db Drivers da seguinte maneira. Para obter mais informações sobre a configuração do Agente remoto, consulte Exibir ou editar Jitterbit Conf em Agentes > Grupos de Agente.

No Management Console, vá para Agentes > Grupos de Agente.
Dentro da tabela, encontre seu Grupo de Agentes e use o menu suspenso Action para selecionar Jitterbit Conf.
No pop-up, selecione a aba Db Drivers e clique em Edit no canto superior direito. Localize a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de exemplo fornecidas por aquelas para seu driver ODBC Oracle específico. Ao concluir, clique em Enviar para salvar as informações do driver no arquivo de configuração do Jitterbit Agente.
```
#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.

Windows Linux

No menu Iniciar:

Parar os serviços Jitterbit
Iniciar os serviços Jitterbit

No diretório de instalação do Jitterbit Agent:

> StopServices.bat
> StartServices.bat

A partir de um prompt:

$ sudo jitterbit stop
$ sudo jitterbit start

Configuração Manual do Agente¶

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

Abra jitterbit.conf em um editor de texto e vá até a seção [DbDrivers].
Localize a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de amostra fornecidas por aquelas de seu driver ODBC Oracle específico. Ao concluir, salve o arquivo jitterbit.conf.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```