Ir para o conteúdo

Conexão com o banco de dados

Introdução

Uma conexão com o banco de dados, criada usando 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 Jitterbit ou instalado nos agentes privados Jitterbit. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades de banco de dados associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector suporta a Habilitar Reautenticação em Caso de Alteração política de organização. Se habilitado, uma alteração no Nome do Servidor ou Login na conexão de um endpoint exigirá que os usuários reentrem a Senha para a conexão.

Criar ou editar uma conexão com o banco de dados

Uma nova conexão com o banco de dados é criada usando o conector de banco de dados a partir de uma dessas localizações:

Uma conexão com o banco de dados existente pode ser editada a partir dessas localizações:

Configurar uma conexão de banco de dados

Cada elemento da interface do usuário da tela de configuração da conexão de banco de dados é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão de 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 (:). Este nome também é usado para identificar o endpoint do banco de dados, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Tipo de driver: Para filtrar a lista de drivers, selecione o botão para o tipo de driver apropriado. Agentes em nuvem suportam um conjunto limitado de drivers JDBC apenas, enquanto agentes privados suportam tanto drivers ODBC quanto JDBC e você pode instalar drivers adicionais (veja Drivers de banco de dados em agentes privados Jitterbit para mais informações).

  • Driver: Use a lista para selecionar o driver de banco de dados. Os drivers disponíveis dependem se você está usando agentes em nuvem ou agentes privados (veja Drivers de banco de dados). Quando você seleciona um driver de banco de dados, os campos restantes disponíveis nesta tela de configuração podem mudar, pois apenas 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 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 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 utilizada no campo Porta abaixo.

  • Porta: (Este campo é habilitado apenas se a caixa Usar Porta Padrão estiver desmarcada.) Insira uma porta personalizada apenas se o servidor de banco de dados estiver escutando em uma porta não padrão.

  • Configurações Opcionais: Clique para expandir para configurações opcionais adicionais.

    • Habilitar Lote: Disponível apenas ao usar um driver JDBC, selecione esta caixa de seleção para melhorar o desempenho ao trabalhar com grandes quantidades de dados nas atividades de Inserir ou Atualizar. Se as configurações Habilitar Lote e Otimizar para Dados em Lote estiverem visíveis, selecionar qualquer uma habilita a mesma funcionalidade.

    • Otimizar para Dados em Lote: Disponível apenas quando o driver de banco de dados Oracle ou SQL Server jTDS é selecionado, selecione esta caixa de seleção para melhorar o desempenho ao trabalhar com grandes quantidades de dados nas atividades de Inserir ou Atualizar. Se as configurações Habilitar Lote e Otimizar para Dados em Lote estiverem visíveis, selecionar qualquer uma habilita a mesma funcionalidade.

    • Nível de Isolamento de Transação: Se aplicável, use o menu suspenso para selecionar o nível de isolamento de transação. Níveis de isolamento de transação específicos do driver não são suportados. A opção DEFAULT utiliza 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).

    • 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: Insira quaisquer parâmetros adicionais para a string de conexão do banco de dados aqui. Este campo é desativado ao usar a opção de string de conexão abaixo.

      Dica

      Para autenticação do Microsoft Entra ao usar SQL Server Microsoft, insira authentication=ActiveDirectoryPassword neste campo.

    • Usar String de Conexão: Selecione 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 String de Conexão estiver em branco, o Nome do Servidor, Login e Senha conforme configurados acima serã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 estar marcada 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 string de conexão será visível em texto claro durante a configuração, portanto, 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 Senha fornecidos como parte da interface do usuário. Eles serão então anexados à string de conexão quando necessário, mas não estarão visíveis na tela.

  • Teste: Clique para verificar a conexão com o banco de dados. Ao testar uma conexão de banco de dados, o caractere de aspas usado pelo banco de dados, seja uma aspa simples ou uma aspa dupla, é identificado. Se você não testar a conexão neste momento, as informações de aspas de abertura e fechamento serão buscadas 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 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Conceitos básicos do conector.

Após 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 fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou você pode usar a conexão de Banco de Dados em um script.

Configurar atividades

Esses tipos de atividade estão disponíveis:

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

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

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

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

Usar 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 utilizam um databaseId como parâmetro:

Funções de script Jitterbit

Funções Jitterbit em JavaScript

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