Ir para o conteúdo

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

Nota

O Jitterbit oferece diversos conectores específicos de aplicativos para bancos de dados comumente usados. Para obter uma lista completa, consulte Conectores.

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 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 na guia Endpoints e conectores 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 destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Tipos de atividade de banco de dados

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

  • Inserir: Insere novos dados em um endpoint de banco de dados e é destinada a ser usada como destino em uma operação ou chamada em um script.

  • Atualizar: Atualiza dados existentes em um endpoint de banco de dados e é destinada a ser usada como destino em uma operação ou chamada em um script.

  • Upsert: Atualiza dados existentes e insere novos dados em um endpoint de banco de dados e é destinada a ser usada como destino em uma operação ou chamada em um script. (O Harmony oferece suporte a atividades Upsert para bancos de dados usando uma combinação de Consulta, Inserir e Atualizar.)

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 a função DBExecute em um Jitterbit Script especificando o comando SQL a ser executado no banco de dados.

Nota

Este conector é um conector nativo do Studio, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores. O cronograma de lançamento para conectores nativos do Studio é baseado na cadência de aplicativos web do portal Harmony.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

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, pois agentes de nuvem suportam apenas drivers JDBC, enquanto agentes privados suportam drivers ODBC e JDBC.

Agentes de nuvem

Grupos de agentes de nuvem suportam apenas drivers JDBC. Um conjunto de drivers JDBC comumente usados é fornecido:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server MS JDBC (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.

Estes 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 MS JDBC (Microsoft)
  • SQLite
  • Sybase jTDS

Estes drivers ODBC são inclusos na instalação do agente privado Windows de 64 bits:

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

Este driver ODBC é 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 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 estes 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

Transport Layer Security (TLS) 1.3 e 1.2 são suportados para endpoints de banco de dados JDBC.

Em agentes privados, TLS 1.0 ou 1.1 pode ser reativado (embora não 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 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 usar um agente privado, você pode especificar caracteres usados para definir delimitadores em nomes de tabelas/colunas de banco de dados no arquivo de configuração do agente privado na seção [DbDrivers].

Se usar 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 tratados pelo driver. Por exemplo, campos de banco de dados que possuem um sinal de arroba (@) não estão em conformidade com especificações baseadas em SQL e podem não ser suportados. 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 nos nomes de colunas e usar essa em seu lugar.

Solução de problemas e guias práticos

Se você enfrentar problemas com o conector de Banco de Dados, recomenda-se seguir estas etapas de solução de problemas:

  1. Garanta que a conexão de 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 escrita durante a execução da operação.

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

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

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

  6. Para problemas e resoluções específicos do conector de Banco de Dados, consulte o guia Solução de problemas do conector:

As páginas a seguir fornecem instruções adicionais para trabalhar com o conector de banco de dados:

Recursos adicionais

Diversos funções de banco de dados podem ser usadas em scripts para fornecer acesso a interações básicas de banco de dados, incluindo:

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

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