Ir para o conteúdo

Configurar uma Origem 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 Cliente Oracle no Jitterbit Agente Privado

Antes de poder 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 Cliente Oracle deverá ser instalado em todos os Agentes do grupo. Consulte Agentes > Agentes e Agentes > Grupos de Agente Para maiores informações.

Configurar e Testar o Cliente Oracle

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 da Oracle para a versão que você está usando.

Depois que o Oracle Client for configurado no Jitterbit Agente, você deverá 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 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 a definição de uma ou mais das seguintes variáveis de ambiente no sistema operacional. 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 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

Configure a Conexão Oracle no Jitterbit Studio

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

  1. Vá para o Jitterbit Studio e configure sua origem ou destino normalmente, escolhendo Database como o tipo.
  2. Selecione seu Driver clicando no botão Selecionar para exibir um prompt para selecionar os drivers disponíveis. No prompt, certifique-se de que a caixa de seleção ODBC esteja marcada, selecione seu driver na lista e clique em OK. Se você não encontrar seu driver na lista, consulte Adicionar seu driver ao arquivo de configuração do Jitterbit Agente abaixo.
  3. Clique em Opções para expandir 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. 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 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 de Agente Remoto

Se você tiver a configuração remota do Agente habilitada por meio do Management Console, você pode adicionar as informações do driver na aba Db Drivers da seguinte maneira. Para obter mais informações sobre a configuração remota do Agente, consulte Visualizar ou editar Jitterbit Conf em Agentes > Grupos de Agente.

  1. Dentro do Management Console, vá para Agentes > Grupos de Agente.

  2. Na tabela, encontre seu Grupo de Agentes e use o menu suspenso Ação para selecionar Jitterbit Conf.

  3. No pop-up, selecione a aba Db Drivers e clique em Editar no canto superior direito. Encontre a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de amostra fornecidas pelas informações de 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'='\"'
    
  4. 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 interrompa 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 Agente:

    > 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, poderá adicionar as informações do seu 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).

  1. Abra jitterbit.conf em um editor de texto e vá até a seção [DbDrivers].

  2. Encontre a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de amostra fornecidas pelas informações de seu driver Oracle ODBC 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'='\"'
    
  3. 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 interrompa 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 Agente:

    > StopServices.bat
    > StartServices.bat

    De um prompt:

    $ sudo jitterbit stop
    $ sudo jitterbit start