Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Conexão com o banco de dados

Introdução

Uma conexão de 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 agentes de nuvem Jitterbit ou instalado em agentes privados Jitterbit. Depois que uma conexão é configurada, você pode 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 política da organização Habilitar Reautenticação na Alteração. Se habilitado, uma alteração no Nome do Servidor ou Login na conexão de um endpoint exigirá que os usuários insiram novamente a Senha para a conexão.

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:

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

Configurar uma conexão de banco de dados

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

Configuração de conexão do banco de dados

Dica

Campos com um suporte a ícones variáveis usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista de variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para usar 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. Agentes de nuvem suportam apenas um conjunto limitado de drivers JDBC, enquanto agentes privados suportam drivers ODBC e 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 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). 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 será habilitado somente 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:

    configurações opcionais de conexão de banco de dados

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

Próximos passos

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

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

Use 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 do Jitterbit Script

Funções JavaScript Jitterbit

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