Instalar Drivers ODBC Ou JDBC Adicionais¶
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 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 agente privado do Windows de 64 bits:
- PostgreSQL ANSI (x64)
- PostgreSQL Unicode (x64)
Este driver ODBC é fornecido com a instalação do agente privado Linux de 64 bits:
PostgreSQL-jitterbit
Nota
Drivers somente para agentes privados de 64 bits estão listados acima, já que 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 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.
-
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.
-
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 substituído ao atualizar um agente privado. Em vez disso, recomendamos colocar todos os drivers que você instalar em<JITTERBIT_HOME>/tomcat/drivers/lib/
. -
-
Para agentes privados Linux, configure a propriedade do arquivo copiado:
sudo chown jitterbit:jitterbit <JITTERBIT_HOME>/tomcat/drivers/lib/*.jar
-
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 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 subprotocolopostgresql
. Consulte a documentação do driver para obter 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 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>
-
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 JitterbitNo diretório de instalação do Agente Jitterbit:
> StopServices.bat
> StartServices.bat
De um prompt:
$ sudo jitterbit stop
$ sudo jitterbit start
-
Teste no aplicativo de administração JDBC para garantir a conectividade entre o driver e a fonte de dados subjacente.
-
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:
-
Cloud Studio: Em Cloud Studio, o driver aparece automaticamente ao configurar uma conexão de banco de dados.
-
Design Studio: Em Design Studio, o driver deverá aparecer automaticamente ao configurar uma Fonte do banco de dados ou alvo. Caso contrário, tente atualizar a tela de seleção de driver.
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.
-