Conector de banco de dados para Jitterbit Integration Studio
Resumo
O conector de banco de dados estabelece acesso a um banco de dados por meio de um driver JDBC ou ODBC fornecido com agentes de nuvem Jitterbit ou instalado em agentes privados Jitterbit.
Nota
O Jitterbit oferece uma série de conectores específicos de aplicativos para bancos de dados comumente usados. Para uma lista completa, veja Connectors.
O conector de banco de dados fornece uma interface para criar uma conexão de banco de dados, a base usada para gerar instâncias de atividades do Database. Essas atividades, uma vez configuradas, interagem com o banco de dados por meio da conexão.
O conector do banco de dados é acessado na aba Conectores e endpoints do projeto da paleta de componentes de design (consulte paleta de componentes de design).
Visão geral do conector
Este conector é usado para configurar primeiro uma conexão de banco de dados. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que devem ser usadas como origens (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).
Juntas, uma conexão de banco de dados específica e suas atividades são chamadas de endpoint de banco de dados:
-
Consulta: Consulta dados de um endpoint do banco de dados e deve ser usado como fonte em uma operação ou chamado em um script.
-
Inserir: Insere novos dados em um endpoint do banco de dados e deve ser usado como um alvo em uma operação ou chamado em um script.
-
Atualizar: Atualiza dados existentes em um endpoint do banco de dados e deve ser usado como um alvo em uma operação ou chamado em um script.
-
Inserir: Atualiza dados existentes e insere novos dados em um endpoint do banco de dados e deve ser usado como um destino em uma operação ou chamado em um script. (O Harmony oferece suporte a atividades Upsert para bancos de dados usando uma combinação de Consulta, Inserção e Atualização.)
Dica
Como não há atividade de exclusão de banco de dados, para excluir dados de uma conexão de banco de dados, use o DBExecute função em um Jitterbit Script especificando o comando SQL a ser executado no banco de dados.
Nota
Este conector é um nativo Integration Studio conector, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores. O cronograma de lançamento para nativo Integration Studio conectores é baseado na cadência dos aplicativos web do portal Harmony.
Versões suportadas e limitações
Bancos de dados suportados
A maioria dos bancos de dados compatíveis com JDBC e ODBC são suportados. Sua escolha de agente também afeta o tipo de driver que você pode usar, como agentes de nuvem suportam apenas drivers JDBC, enquanto agentes privados suportam drivers ODBC e JDBC.
Agentes de nuvem
Os grupos de agentes de nuvem oferecem suporte apenas a drivers JDBC. Um conjunto de drivers JDBC comumente usados é fornecido:
- Amazon Redshift
- IBM DB2 (AS400)
- MySQL
- Oracle (JDBC 19.7)
- Oracle NetSuite
- PostgreSQL
- SQL Server jTDS
- SQL Server MS JDBC
- Sybase jTDS
Agentes privados
Agentes privados dão suporte a drivers JDBC e drivers ODBC. Para drivers ODBC, a arquitetura do driver deve corresponder ao sistema do agente. Ou seja, agentes de 64 bits dão suporte a drivers ODBC de 64 bits.
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 (JDBC 19.7)
- 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
Além disso, você pode instalar outros drivers de banco de dados em agentes privados conforme necessário. Para obter informações gerais e instruções sobre como instalar drivers adicionais em agentes privados, consulte Instalar drivers ODBC ou JDBC adicionais.
Dados suportados
Em bancos de dados, o Jitterbit não suporta dados com esses tipos de codificação ou nomes de objetos:
- Dados binários
- Dados Unicode/UTF
- Tabelas ou visualizações com espaços nos nomes
Versões TLS suportadas
O Transport Layer Security (TLS) 1.3 e 1.2 são suportados para endpoints de banco de dados JDBC.
Em agentes privados, o TLS 1.0 ou 1.1 pode ser reativado (embora não seja recomendado) removendo TLSv1 ou TLSv1.1 do jdk.tls.disabledAlgorithms propriedade de segurança no agente privado java.security arquivo de configuração.
O agente privado java.security O arquivo de configuração está localizado nestes diretórios padrão:
-
Windows:
C:\Program Files\Jitterbit Agent\jre\lib\security -
Linux:
/opt/jitterbit/jre/lib/security
Caracteres especiais em nomes de tabelas/colunas de banco de dados
Se estiver usando um agente privado, você pode especificar caracteres usados para definir delimitadores dentro de nomes de tabelas/colunas de banco de dados no arquivo de configuração do agente privado sob o [DbDrivers] seção.
Se estiver usando um driver de banco de dados ODBC, observe que alguns caracteres especiais em nomes de tabelas/colunas de banco de dados não podem ser manipulados pelo driver. Por exemplo, campos de banco de dados que têm um sinal de arroba (@) não são compatíveis com especificações baseadas em SQL e podem não ser suportadas. Se o banco de dados usar tais caracteres especiais em nomes de tabelas/colunas, como solução alternativa, recomendamos criar uma visualização na tabela física que não use o caractere especial em nomes de colunas e usá-lo em vez disso.
Solução de problemas e tutoriais
Se você tiver problemas com o conector do banco de dados, estas etapas de solução de problemas são recomendadas:
-
Certifique-se de que a conexão do banco de dados for bem-sucedida usando o botão Test na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado pode fornecer uma indicação do problema.
-
Verifique os registros de operação para qualquer informação escrita durante a execução da operação.
-
Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
-
Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.
-
Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.
Além disso, as páginas a seguir fornecem instruções detalhadas sobre como realizar determinadas tarefas com projetos de integração que usam o conector de banco de dados:
Recursos adicionais
Várias funções de banco de dados podem ser usadas em scripts para fornecer acesso a interações básicas de banco de dados, incluindo estas:
CacheLookupCallStoredProcedureDBCloseConnectionDBExecuteDBLoadDBLookupDBLookupAllDBRollbackTransactionDBWriteSetDBInsertSetDBUpdateSQLEscapeUnmap<SEQUENCE><SQLIDENTITY><UDF>
Para obter detalhes sobre o uso dessas funções, consulte Funções de banco de dados.