Ir para o conteúdo

Instale Drivers ODBC Ou JDBC Adicionais

Introdução

Jitterbit fornece drivers de banco de dados comumente usados, empacotados 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 em Nuvem.

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

Drivers Fornecidos em 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
  • SQLite
  • Sybase jTDS

Esses drivers ODBC são fornecidos com a instalação do Windows Agente Privado de 64 bits:

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

Este driver ODBC é fornecido com a instalação do Linux Agente Privado de 64 bits:

PostgreSQL-jitterbit

Nota

Os drivers apenas para Agentes Privados de 64 bits estão listados acima, já que os Agentes Privados de 32 bits estão em fim de vida.

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 Cloud Studio Informações específicas do banco de dados ou Design Studio banco de dados.

As etapas genéricas para instalação de drivers JDBC adicionais são fornecidas abaixo. Drivers ODBC adicionais instalados no Windows não requerem 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 SQL Server JDBC Driver, incluindo seus arquivos JAR disponíveis, está disponível na Microsoft em Download Microsoft JDBC Driver for 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/; entretanto, este diretório pode ser substituído ao atualizar um Agente Privado. Em vez disso, recomendamos colocar todos os drivers instalados em <JITTERBIT_HOME>/tomcat/drivers/lib/.

  3. Para Linux Agentes Privados, 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 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 interface de seleção do driver. Alterar o nome interromperá os projetos existentes que usam esse driver. Para recuperar, todos os endpoints do banco de dados que usam esse driver devem ser atualizados selecionando novamente o driver com o novo nome e, em seguida, reimplantando.
    <Class> O nome completo da classe do driver. Consulte a documentação do driver específico.
    <Subprotocol> O subprotocolo a ser usado ao construir a URL para conexão com um banco de dados usando o driver. O URL está no formato jdbc:subprotocol://.... Por exemplo, um driver PostgreSQL pode definir o subprotocolo postgresql. Consulte a documentação do driver para obter detalhes.
    <BeginQuote> Defina seu próprio caractere "aspas iniciais" (raramente necessário).
    <EndQuote> Defina seu próprio caractere de "aspas finais" (raramente necessário).

    Você pode encontrar exemplos no JdbcDrivers.conf arquivo. Por exemplo, o driver JDBC do SQL Server 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 interrompa os serviços e depois reinicie-os.

    Windows Linux
    No menu Iniciar:

    Parar serviços Jitterbit
    Iniciar serviços Jitterbit

    No 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. Depois de instalado com sucesso, o driver adicional é detectado no sistema operacional do servidor 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 cadeia de conexão deve ser estruturada. Para obter informações adicionais sobre bancos de dados selecionados, consulte Cloud Studio Informações específicas do banco de dados ou Design Studio banco de dados.