Conexão com o Banco de Dados¶

Introdução¶

Uma conexão de banco de dados é configurada usando o conector de banco de dados, estabelecendo acesso a um banco de dados. Depois que uma conexão é estabelecida, você pode configurar uma ou mais atividades de banco de dados associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou script, ou como um destino para consumir dados em uma operação ou script.

Os agentes de nuvem oferecem suporte a um conjunto fornecido de drivers JDBC. Agentes privados suportam drivers ODBC e JDBC. Além dos drivers fornecidos, você pode instalar drivers ODBC e JDBC adicionais em agentes privados.

Para converter uma conexão de banco de dados existente usando um driver ODBC para usar um driver JDBC, consulte Convertendo de ODBC para JDBC mais adiante nesta página.

Criar Ou Editar uma Conexão de Banco de Dados¶

Uma nova conexão de banco de dados é criada usando o conector de banco de dados de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

Uma conexão de banco de dados existente pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma Conexão de Banco de Dados¶

A configuração de uma conexão de banco de dados inclui estes campos:

• Nome do Endpoint: Insira um nome a ser usado para identificar a conexão do banco de dados. O nome deve ser exclusivo para cada conexão do banco de dados e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do banco de dados, que se refere a uma conexão específica e suas atividades.

• Tipo de driver: Para filtrar a lista de drivers, selecione o botão para o tipo de driver apropriado.

• Driver: Use o menu suspenso para selecionar o driver do banco de dados. Os drivers disponíveis dependem se você está usando agentes de nuvem ou agentes privados (consulte Drivers de banco de dados abaixo). Quando você seleciona um driver de banco de dados, os campos restantes disponíveis nesta tela de configuração podem mudar, pois somente os campos aplicáveis ao driver de banco de dados selecionado são exibidos.

• Nome do servidor: Insira o nome, URL ou endereço IP do servidor de banco de dados.

• Nome do banco de dados: Se aplicável, insira o nome do banco de dados. Este campo pode não estar presente para drivers de banco de dados para os quais este campo não é aplicável, como Oracle.

• Login e Senha: Se aplicável, insira um nome de usuário e uma senha que permitam acesso ao banco de dados. Você pode deixar esses campos em branco se nenhum nome de usuário ou senha for necessário.

• Usar porta padrão: Mantenha esta caixa de seleção marcada para usar a porta padrão. A porta padrão difere dependendo do driver selecionado. Se você não quiser usar a porta padrão, desmarque a caixa de seleção Usar porta padrão e insira a porta a ser usada no campo Porta abaixo.

• Porta: (Este campo só será habilitado se a caixa Usar porta padrão estiver desmarcada.) Insira uma porta personalizada somente se o servidor de banco de dados estiver escutando em uma porta não padrão.

• Configurações opcionais: Clique para expandir e ver configurações opcionais adicionais:

  

  • Otimizar para dados em massa: Disponível somente quando o driver de banco de dados Oracle ou SQL Server jTDS estiver selecionado. Marque esta caixa de seleção para melhorar o desempenho ao trabalhar com grandes quantidades de dados.

  • Nível de isolamento de transação: Se aplicável, use o menu suspenso para selecionar o nível de isolamento Transact-SQL (T-SQL). Os níveis de isolamento de transação específicos do driver não são suportados. A opção DEFAULT usa o nível de isolamento de transação padrão do driver ou do servidor de banco de dados.

  • Timeout (seg): Para definir um limite de quanto tempo esperar por uma conexão bem-sucedida com o banco de dados, insira um número de segundos aqui. O padrão é 300 segundos (5 minutos).

  • Fetch Size: Se estiver usando um driver JDBC, isso informa ao driver quantas linhas devem ser buscadas quando mais linhas forem necessárias. Isso pode ser usado para melhorar o processamento de grandes conjuntos de dados.

  • Parâmetros Adicionais de String de Conexão: Para adicionar parâmetros adicionais à string de conexão do banco de dados, insira-os aqui. Observe que este campo estará desabilitado se você tiver selecionado a opção abaixo para usar uma string de conexão.

  • Usar sequência de conexão: Selecione esta caixa de seleção para inserir uma sequência de conexão no campo abaixo. Se selecionado, isso desabilita e substitui os Parâmetros adicionais de sequência de conexão acima. Se selecionado e o campo Sequência de conexão for deixado em branco, o Nome do servidor, Login e Senha conforme configurado acima são usados.

  • String de conexão: Se aplicável, insira uma string de conexão na caixa de texto. A caixa de seleção acima deve ser selecionada para que este campo seja habilitado.

    Dica

    Consulte a documentação específica do banco de dados para criar strings de conexão manuais. Exemplos também podem ser encontrados em https://www.connectionstrings.com.

    Nota

    A sequência de conexão ficará visível em texto simples durante a configuração, então você pode não querer incluir o nome de usuário e a senha na sequência. Em vez de incluir esses parâmetros e valores na sequência, use os campos Login e Senha fornecidos como parte da IU. Eles serão anexados à sequência de conexão quando necessário, mas não ficarão visíveis na tela.

• Teste: Clique para verificar a conexão com o banco de dados. Quando você testa uma conexão com o banco de dados, o caractere de aspas usado pelo banco de dados, seja uma aspa simples ou dupla, é identificado. Se você não testar a conexão neste momento, as informações de aspas de abertura e fechamento serão obtidas quando você configurar uma atividade.

• Salvar alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Drivers de Banco de Dados¶

Os drivers disponíveis para seleção no menu suspenso Driver dependem se você está usando agentes de nuvem ou agentes privados.

Agentes de Nuvem¶

Os grupos de agentes de nuvem oferecem suporte apenas a drivers JDBC. Esses drivers JDBC são fornecidos:

• IBM DB2 (AS400)

• MySQL

• Oracle

• Oracle NetSuite

• PostgreSQL

• Desvio para o vermelho

• 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 32 bits dão suporte a drivers ODBC de 32 bits e 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
• 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

Drivers adicionais são detectados pelo sistema operacional. Você pode instalar drivers de banco de dados adicionais conforme necessário.

Próximos Passos¶

Após uma conexão de banco de dados ter sido criada, as ações de menu para essa conexão ficam acessíveis na aba Componentes do painel do projeto. Veja menu de ações de conexão para mais detalhes.

Depois de configurar uma conexão de banco de dados, você pode configurar uma ou mais atividades de banco de dados associadas a essa conexão para serem usadas como uma origem (para fornecer dados dentro de uma operação), como um destino (para consumir dados dentro de uma operação) ou em um script, ou você pode usar a conexão de banco de dados em um script.

Configurar Atividades¶

As atividades do banco de dados interagem com a conexão do banco de dados para atuar como fontes (fornecendo dados dentro de uma operação) ou destinos (recebendo dados dentro de uma operação).

Depois de configurar uma conexão de banco de dados, use o menu suspenso Mostrar para filtrar por Endpoints e, em seguida, clique no bloco Conexão de banco de dados para exibir atividades que estão disponíveis para serem usadas com uma conexão de banco de dados:

Para mais informações, veja estas atividades:

• 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.)

Usando Conexões de Banco de Dados em Scripts¶

As conexões de banco de dados podem ser referenciadas em um script usando funções de script que usam um databaseId como parâmetro:

Funções de Jitterbit Script

• CacheLookup
• CallStoredProcedure
• DBCloseConnection
• DBExecute
• DBLookup
• DBLookupAll
• DBRollbackTransaction
• DBWrite

Funções Jitterbit do JavaScript

• Jitterbit.DbExecute
• Jitterbit.DbLookup

Para obter mais detalhes sobre como referenciar endpoints em scripts, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.

Convertendo de ODBC para JDBC¶

Converter uma conexão de banco de dados de usar um driver ODBC para usar um driver JDBC é geralmente um processo direto. Você pode precisar fazer isso se mover um projeto de execução em um agente privado usando um driver ODBC para um grupo de agentes de nuvem Jitterbit que, a partir do Harmony 9.8, não suportam mais drivers ODBC nos grupos de agentes de nuvem.

Se sua conexão usar as opções padrão, você pode convertê-la rapidamente seguindo as etapas descritas abaixo. No entanto, se você usou a opção para especificar parâmetros de string de conexão adicionais ou para construir a string de conexão manualmente, precisará ajustar essas opções para acomodar as diferenças entre ODBC e JDBC.

Suporte Jitterbit está disponível para ajudar você a converter sua conexão para JDBC se você precisar de assistência com a conversão de suas conexões de banco de dados ou a revisão de opções avançadas.

Convertendo Conexões Simples de Banco de Dados¶

Para converter uma conexão de banco de dados que atualmente usa um driver ODBC para uma que usa um driver JDBC, siga estas etapas:

1. Abra a conexão do Banco de Dados que usa um driver ODBC. Neste exemplo, uma conexão usando o driver PostgreSQL foi aberta:

   

2. Teste a conexão clicando no botão Test para certificar-se de que funciona:

   

3. Se a conexão foi bem-sucedida, você pode prosseguir com esta conversão. Caso contrário, corrija quaisquer erros antes de continuar.

4. Verifique se algum parâmetro de conexão adicional foi especificado clicando em Configurações opcionais na parte inferior da tela de configuração:

   

   • Se nenhum parâmetro de conexão adicional foi especificado além dos padrões mostrados acima, você pode prosseguir com a conversão da conexão do banco de dados seguindo o restante destas instruções.
   • Se houver parâmetros de conexão adicionais especificados além dos padrões mostrados acima, consulte a próxima seção em Convertendo conexões com parâmetros de conexão adicionais.

5. Altere o Tipo de driver para JDBC e use o menu suspenso Driver para selecionar o driver JDBC apropriado. Neste exemplo, selecionamos o driver JDBC PostgreSQL.

   

6. Teste a conexão revisada clicando no botão Test para certificar-se de que funciona:

   

7. Clique no botão Salvar alterações para salvar a conexão revisada do banco de dados.

Convertendo Conexões com Parâmetros de Conexão Adicionais¶

Se sua conexão usar parâmetros de conexão adicionais além dos valores padrão mostrados acima, como Parâmetros Adicionais de String de Conexão ou a caixa Usar String de Conexão foi marcada e a string de conexão foi inserida manualmente, trabalho adicional pode ser necessário para converter a conexão de ODBC para JDBC. Por exemplo, os Parâmetros Adicionais de String de Conexão do ODBC do SQL Server podem ser (para usar a Autenticação NTLM do Windows ):

integratedSecurity=true

Um driver JDBC equivalente do SQL Server jTDS Parâmetros adicionais de string de conexão (para usar a autenticação NTLM do Windows ) seria:

useNTLMv2=true

Os parâmetros de string de conexão são específicos para o driver de banco de dados que você usa (por exemplo, Microsoft SQL, MySQL, PostgreSQL ou Oracle). Revise as especificações do driver para determinar os parâmetros necessários. Se precisar de assistência para converter strings de conexão ou parâmetros para um driver JDBC, entre em contato com suporte Jitterbit.