Ir para o conteúdo

Instalar drivers ODBC ou JDBC adicionais em agentes privados Jitterbit

Introdução

Jitterbit fornece drivers de banco de dados comumente usados, agrupados com o agente privado software ou detectado no sistema operacional do servidor no qual um agente privado está instalado.

Drivers JDBC e ODBC adicionais podem ser instalados somente em agentes privados:

  • JDBC: Você pode instalar drivers JDBC adicionais em qualquer agente privado, seja ele baseado em Windows ou Linux.
  • ODBC: Para drivers ODBC, a arquitetura do driver deve corresponder ao sistema do agente. Os agentes suportam drivers ODBC de 64 bits.

Drivers adicionais não podem ser instalados em agentes de nuvem.

Esta página lista os drivers fornecidos e descreve as etapas genéricas para instalar drivers adicionais em um agente privado.

Motoristas fornecidos por agentes privados

Esses drivers JDBC são fornecidos por agentes privados do Windows e Linux de 64 bits:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • IBM DB2 (JCC)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server Microsoft
  • SQLite
  • Sybase jTDS

Esses drivers ODBC estão incluídos na instalação do agente privado do Windows de 64 bits:

  • PostgreSQL ANSI (x64)
  • PostgreSQL Unicode (x64)

Este driver ODBC está incluído na instalação do agente privado Linux de 64 bits:

  • PostgreSQL-jitterbit

Nota

Drivers para agentes privados de apenas 64 bits estão listados acima, já que os agentes privados de 32 bits estão no fim da vida útil.

Instalação de driver em agentes privados

Ao instalar drivers adicionais, consulte a documentação do driver específico que você está instalando. Para obter informações adicionais sobre bancos de dados selecionados, consulte Integration StudioInformações específicas do banco de dados ou Design Studio Banco de Dados.

Etapas genéricas para instalar drivers JDBC adicionais são fornecidas abaixo. Drivers ODBC adicionais instalados no Windows não exigem nenhuma configuração adicional.

  1. Obtenha o arquivo JAR do driver. Em muitos casos, eles estão disponíveis para download no fabricante do driver.

    Por exemplo, o driver JDBC do SQL Server, incluindo seus arquivos JAR disponíveis, está disponível na Microsoft em Baixar driver JDBC da Microsoft para SQL Server.

  2. Copie o arquivo JAR para o seguinte caminho de pasta recomendado: <JITTERBIT_HOME>/tomcat/drivers/lib/, substituindo <JITTERBIT_HOME> com o diretório raiz do agente privado. O diretório raiz do agente privado geralmente está em um destes locais padrão:

    • Windows (Harmony): C:\Program Files\Jitterbit Agent\

    • Linux: /opt/jitterbit

    Cuidado

    Os arquivos JAR também podem estar localizados em <JITTERBIT_HOME>/tomcat/webapps/axis/WEB-INF/lib/; no entanto, este diretório pode ser sobrescrito ao atualizar um agente privado. Em vez disso, recomendamos colocar todos os drivers que você instalar em <JITTERBIT_HOME>/tomcat/drivers/lib/.

  3. Para agentes privados do Linux, defina a propriedade do arquivo copiado:

    sudo chown jitterbit:jitterbit <JITTERBIT_HOME>/tomcat/drivers/lib/*.jar

  4. Localize o JdbcDrivers.conf arquivo no diretório raiz do agente privado. Abra o arquivo no modo de administrador e adicione um novo <Driver> elemento no <Drivers> seção com essas informações e salve o arquivo:

    Elemento
    		 Descrição
    <Name> O nome do driver. Deve ser um nome exclusivo. Este nome aparecerá na IU de seleção do driver. Alterar o nome quebrará os projetos existentes que usam este driver. Para recuperar, todos os endpoints do banco de dados que usam este driver devem ser atualizados selecionando novamente o driver com o novo nome e, em seguida, implantando novamente.
    <Class> O nome completo da classe do driver. Veja a documentação do driver em questão.
    <Subprotocol> O subprotocolo a ser usado ao construir a URL para conectar-se a um banco de dados usando o driver. A URL tem o formato jdbc:subprotocol://.... Por exemplo, um driver PostgreSQL pode definir o subprotocolo postgresql. Veja a documentação do driver para mais detalhes.
    <BeginQuote> Defina seu próprio caractere "begin-quote" (raramente necessário).
    <EndQuote> Defina seu próprio caractere "final de aspas" (raramente necessário).

    Você pode encontrar exemplos no JdbcDrivers.conf arquivo. Por exemplo, o SQL Server JDBC Driver usa estas informações:

    <Driver>
<Name>SQL Server</Name>
<Class>com.microsoft.sqlserver.jdbc.SQLServerDriver</Class>
<Subprotocol>sqlserver</Subprotocol>
</Driver>

  5. Na máquina onde cada agente privado está instalado, primeiro pare os serviços e depois reinicie-os.

    Windows Linux
    Do menu Iniciar:

    Parar serviços Jitterbit
    Iniciar serviços Jitterbit

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

    > StopServices.bat
    > StartServices.bat

    De um prompt:

    $ sudo jitterbit stop
    $ sudo jitterbit start

  6. Teste no aplicativo de administração JDBC para garantir a conectividade entre o driver e a fonte de dados subjacente.

  7. Uma vez instalado com sucesso, o driver adicional é detectado pelo sistema operacional do servidor do agente. Agora você deve ver o driver recém-instalado na lista de drivers disponíveis ao configurar um endpoint de banco de dados:

    Nota

    Talvez seja necessário configurar uma string de conexão manual na configuração do endpoint do banco de dados. Consulte a documentação específica do driver sobre como a string de conexão deve ser estruturada. Para obter informações adicionais sobre bancos de dados selecionados, consulte Integration StudioInformações específicas do banco de dados ou Design Studio Banco de Dados.