Conexão de 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 fonte para fornecer dados a uma operação ou script ou como destino para consumir dados em uma operação ou script.

Os Agentes em Nuvem suportam 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 de um driver ODBC para um driver JDBC, consulte Converting from ODBC to 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 Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A página Conexões globais (consulte Criar uma conexão global em Conexões Globais).

Uma conexão de banco de dados existente pode ser editada a partir destes locais:

• A aba Conexões 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 Guia Componentes do painel do projeto).
• A página Conexões globais (consulte Editar uma conexão 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:

• Endpoint Name: Digite um nome a ser usado para identificar a conexão do banco de dados. O nome deve ser exclusivo para cada conexão de banco de dados e não deve conter barras (/) ou dois pontos (:). Esse 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 em Nuvem ou Agentes Privados (consulte Drivers de banco de dados abaixo). Ao selecionar um driver de banco de dados, os demais campos disponíveis nesta tela de configuração podem ser alterados, pois são mostrados apenas os campos aplicáveis ao driver de banco de dados selecionado.

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

• Nome do banco de dados: Se aplicável, digite 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 senha que permitam o 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 não quiser usar a porta padrão, desmarque a caixa de seleção Use Default Port e insira a porta a ser usada no campo Port abaixo.

• Port: (Este campo é ativado apenas se a caixa Use Default Port estiver desmarcada.) Insira uma porta personalizada somente se o servidor de banco de dados estiver atendendo em uma porta não padrão.

• Configurações opcionais: Clique para expandir para 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 da transação: Se aplicável, use o menu suspenso para selecionar o nível de isolamento do Transact-SQL (T-SQL). 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.

  • Tempo limite (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).

  • Tamanho da busca: 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 da string de conexão: Para adicionar parâmetros adicionais à string de conexão do banco de dados, insira-os aqui. Observe que este campo está desabilitado se você selecionou a opção abaixo para usar uma string de conexão.

  • Usar string de conexão: Marque esta caixa de seleção para inserir uma string de conexão no campo abaixo. Se selecionado, isso desativa e substitui os Parâmetros adicionais da string de conexão acima. Se selecionado e o campo Connection String for deixado em branco, Server Name, Login e Password configurados acima serão usados.

  • Cadeia de conexão: Se aplicável, insira uma cadeia de conexão na caixa de texto. A caixa de seleção acima deve ser marcada para que este campo seja ativado.

    Dica

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

    Nota

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

• Test: Clique para verificar a conexão com o banco de dados. Quando você testa uma conexão de 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 cotação de abertura e fechamento serão buscadas quando você configurar uma atividade.

• Save Changes: 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 solicita que você confirme 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, exclusão e remoção de componentes). Uma mensagem solicita que você confirme 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 em Nuvem ou Agentes Privados.

Agentes em Nuvem¶

Grupos de Agentes em Nuvem suportam apenas drivers JDBC. Esses drivers JDBC são fornecidos:

• IBM DB2 (AS400)

• MySQL

• Oracle

• Oracle NetSuite

• PostgreSQL

• redshift

• SQL Server jTDS

SQL Server MS JDBC

• 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 32 bits oferecem suporte a drivers ODBC de 32 bits e agentes de 64 bits oferecem suporte a drivers ODBC de 64 bits.

Esses drivers JDBC são fornecidos por Agentes Privados do Windows e do 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 Windows Agente Privado de 64 bits:

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

Este driver ODBC é fornecido com a instalação do Linux Agente Privado de 64 bits:

• PostgreSQL-jitterbit

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

Próximos Passos¶

Após a criação de uma conexão de banco de dados, as ações do menu para essa conexão podem ser acessadas na guia Componentes do aba do projeto. Consulte Menu de ações de conexão para 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 fonte (para fornecer dados em uma operação), como destino (para consumir dados em 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 em uma operação) ou destinos (recebendo dados em uma operação).

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

Para mais informações, consulte estas atividades:

• Consulta: Consulta dados de um endpoint de banco de dados e destina-se a ser usado como fonte em uma operação ou chamado em um script.
• Inserir: Insere novos dados em um endpoint de Banco de Dados e destina-se a ser usado como destino em uma operação ou chamado em um script.
• Atualizar: Atualiza dados existentes em um endpoint de banco de dados e destina-se a ser usado como destino em uma operação ou chamado em um script.
• Inserir: Ambos atualizam os dados existentes e inserem novos dados em um endpoint do banco de dados e destinam-se a ser usados como destino em uma operação ou chamados em um script. (Jitterbit Harmony suporta 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 JavaScript Jitterbit

• Jitterbit.DbExecute
• Jitterbit.DbLookup

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

Conversão de ODBC para JDBC¶

Converter uma conexão de banco de dados de um driver ODBC para 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 em Nuvem Jitterbit que, a partir de Jitterbit Harmony 9.8, não oferecem mais suporte a drivers ODBC nos Grupos de Agentes em Nuvem.

Se sua conexão usar as opções padrão, você poderá convertê-la rapidamente seguindo as etapas descritas abaixo. No entanto, se você tiver usado a opção de especificar parâmetros adicionais da string de conexão ou de 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 ajudá-lo a converter sua conexão para JDBC se você precisar de ajuda para converter suas conexões de banco de dados ou revisar as opções avançadas.

Convertendo Conexões de Banco de Dados Simples¶

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

1. Abra a conexão de banco de dados que usa um driver ODBC. Neste exemplo, foi aberta uma conexão utilizando o driver PostgreSQL:

   

2. Teste a conexão clicando no botão Testar 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 os 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 Driver Type para JDBC e, em seguida, 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 Testar para certificar-se de que funciona:

   

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

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

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

integratedSecurity=true

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

useNTLMv2=true

Os parâmetros da 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 você precisar de ajuda com a conversão de strings de conexão ou parâmetros para um driver JDBC, entre em contato com Jitterbit Support.