Conector de banco de dados para Jitterbit 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 os agentes em nuvem do Jitterbit ou instalado nos agentes privados do Jitterbit.

O conector de banco de dados fornece uma interface para criar uma Conexão de banco de dados, a base utilizada para gerar instâncias de atividades de banco de dados. Essas atividades, uma vez configuradas, interagem com o banco de dados por meio da conexão.

O conector de banco de dados é acessado a partir da aba Endpoints e conectores do projeto no painel de componentes de design (veja Painel de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma Conexão de banco de dados. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão de banco de dados específica e suas atividades são referidos como um endpoint de banco de dados:

• Consulta: Consulta dados de um endpoint de banco de dados e destina-se a ser usada como uma fonte em uma operação ou chamada em um script.

• Inserir: Insere novos dados em um endpoint de banco de dados e destina-se a ser usada como um alvo em uma operação ou chamada em um script.

• Atualizar: Atualiza dados existentes em um endpoint de banco de dados e destina-se a ser usada como um alvo em uma operação ou chamada em um script.

• Upsert: Atualiza dados existentes e insere novos dados em um endpoint de Banco de Dados, sendo destinado a ser usado como um alvo em uma operação ou chamado em um script. (O Harmony suporta atividades Upsert para bancos de dados usando uma combinação de Query, Insert e Update.)

Versões suportadas e limitações

Bancos de dados suportados

A maioria dos bancos de dados compatíveis com JDBC e ODBC é suportada. Sua escolha de agente também afeta qual tipo de driver você pode usar, já que agentes em nuvem suportam apenas drivers JDBC, enquanto agentes privados suportam tanto drivers ODBC quanto JDBC.

Agentes em nuvem

Grupos de agentes em nuvem suportam apenas 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 (Microsoft)
• Sybase jTDS

Agentes privados

Agentes privados suportam drivers JDBC e drivers ODBC. Para drivers ODBC, a arquitetura do driver deve corresponder ao sistema do agente. Ou seja, agentes de 64 bits suportam drivers ODBC de 64 bits.

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

• 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 de 64 bits para Windows:

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

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

• PostgreSQL-jitterbit

Além disso, é possível instalar outros drivers de banco de dados em agentes privados conforme necessário. Para 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 da propriedade de segurança jdk.tls.disabledAlgorithms no arquivo de configuração java.security do agente privado.

O arquivo de configuração java.security do agente privado está localizado nesses 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 os caracteres usados para definir delimitadores dentro dos nomes de tabelas/colunas de banco de dados no arquivo de configuração do agente privado na seção [DbDrivers].

Se estiver usando um driver de banco de dados ODBC, observe que alguns caracteres especiais nos nomes de tabelas/colunas do banco de dados não podem ser manipulados pelo driver. Por exemplo, campos de banco de dados que possuem um sinal de arroba (@) não estão em conformidade com as especificações baseadas em SQL e podem não ser suportados. Se o banco de dados usar tais caracteres especiais nos nomes de tabelas/colunas, como uma solução alternativa, recomendamos criar uma visão na tabela física que não utilize o caractere especial nos nomes das colunas e usar essa visão em vez disso.

Solução de problemas e como fazer

Se você encontrar problemas com o conector de banco de dados, estas etapas de solução de problemas são recomendadas:

1. Certifique-se de que a conexão com o banco de dados seja bem-sucedida usando o botão Testar na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado pode fornecer uma indicação do problema.

2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

3. Ative o registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

5. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.

Além disso, as seguintes páginas fornecem instruções detalhadas sobre como realizar certas tarefas com projetos de integração que utilizam o conector de banco de dados:

• Conectar ao IBM DB2

• Conectar ao Microsoft

• Conectar ao MySQL

• Conectar ao Oracle

• Conectar ao PostgreSQL

• Conectar ao Progress

• Converter de JDBC para ODBC

• Instalar drivers adicionais

Recursos adicionais

Um número de funções de banco de dados pode ser usado dentro de scripts para fornecer acesso a interações básicas com o banco de dados, incluindo estas:

• CacheLookup
• CallStoredProcedure
• DBCloseConnection
• DBExecute
• DBLoad
• DBLookup
• DBLookupAll
• DBRollbackTransaction
• DBWrite
• SetDBInsert
• SetDBUpdate
• SQLEscape
• Unmap
• <SEQUENCE>
• <SQLIDENTITY>
• <UDF>

Para detalhes sobre como usar essas funções, veja Funções de banco de dados.