Ir para o conteúdo

Conexão de 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 na nuvem Jitterbit ou instalado em agentes privados Jitterbit. Após configurar uma conexão, 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 organizacional Habilitar reautenticação ao alterar. Se habilitada, uma alteração no Nome do servidor ou Login na conexão de um endpoint exigirá que os usuários reinsiram a Senha da 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 em 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 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 de abertura [ no campo ou clique no ícone de variável para exibir um menu listando 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 único 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 de 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 do tipo de driver apropriado. Agentes na nuvem suportam apenas um conjunto limitado de drivers JDBC, enquanto agentes privados suportam drivers ODBC e JDBC e você pode instalar drivers adicionais (consulte 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 na nuvem ou agentes privados (consulte Drivers de banco de dados). Ao selecionar 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.

    Aviso

    A versão 12.10 do agente e posteriores bloqueiam uma conexão de banco de dados com localhost ou 127.0.0.1 por padrão, por segurança. Em um agente privado, consulte [JdbcSecurity] no arquivo de configuração do agente para permitir um banco de dados em execução no mesmo host que o agente.

  • 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 nos quais não é aplicável, como Oracle.

  • Login e Senha: Se aplicável, insira um nome de usuário e senha que permita 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 varia dependendo do driver selecionado. Se não quiser usar a porta padrão, desmarque a caixa de seleção Usar porta padrão e insira a porta a usar no campo Porta abaixo.

  • Porta: (Este campo fica 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 e ver configurações opcionais adicionais.

    • Ativar lote: Disponível apenas ao usar um driver JDBC, marque esta caixa de seleção para melhorar o desempenho ao trabalhar com grandes volumes de dados com atividades de Inserção ou Atualização. Se as configurações Ativar lote e Otimizar para dados em massa estiverem visíveis, selecionar qualquer uma delas ativa a mesma funcionalidade.

      Importante

      Para o driver JDBC do MySQL, adicione também rewriteBatchedStatements=true em Parâmetros adicionais da string de conexão abaixo para obter o benefício total de desempenho de Ativar lote.

    • Otimizar para dados em massa: Disponível apenas quando o driver de banco de dados Oracle ou SQL Server jTDS está selecionado, marque esta caixa de seleção para melhorar o desempenho ao trabalhar com grandes volumes de dados com atividades de Inserção ou Atualização. Se as configurações Ativar lote e Otimizar para dados em massa estiverem visíveis, selecionar qualquer uma delas ativa 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 PADRÃO 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 aguardar 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).

      Dica

      Este limite também se aplica quando o pool de conexões da versão 12.11 do agente e posterior cria uma nova conexão física; em um agente privado, consulte [SourceTargetPooling] no arquivo de configuração do agente. O pool adiciona uma configuração separada jdbc.hikari.connectionTimeout para quanto tempo uma operação aguarda para obter uma conexão do pool, uma vez que todas as conexões em pool estão em uso.

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

      Dica

      Ao usar SQL Server MS JDBC (driver JDBC da Microsoft para SQL Server), insira authentication=ActiveDirectoryPassword neste campo para autenticação do Microsoft Entra. Este campo também controla a criptografia de conexão, descrita em Criptografia de conexão e certificados de servidor.

      Cuidado

      A versão 12.10 do agente e posterior bloqueia ou restringe parâmetros específicos aqui por padrão, por segurança, para os drivers MySQL, PostgreSQL, Oracle e SQL Server. Em um agente privado, consulte [JdbcSecurity] no arquivo de configuração do agente para os parâmetros restritos e como permitir um que você precise.

  • Usar String de Conexão: Marque esta caixa de seleção para inserir uma string de conexão no campo abaixo. Se selecionada, desativa e substitui os Parâmetros Adicionais de String de Conexão acima. Se selecionada e o campo String de Conexão ficar em branco, serão usados o Nome do Servidor, Login e Senha conforme configurados acima.

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

    !!! tip "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](https://www.connectionstrings.com).

!!! note "Nota"
    A string de conexão ficará visível em texto simples durante a configuração, portanto, talvez você não queira 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. Eles serão anexados à string de conexão quando necessário, mas não ficarão visíveis na tela.

!!! caution "Cuidado"
    O Agent versão 12.10 e posterior bloqueia ou restringe parâmetros específicos aqui por padrão, por segurança, para os drivers MySQL, PostgreSQL, Oracle e SQL Server. Em um agent privado, consulte [`[JdbcSecurity]`](/pt/agent/jitterbit-conf/#jdbcsecurity) no arquivo de configuração do agent para ver os parâmetros restritos e como permitir um que você precise.

  • Testar: 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 aspas simples ou duplas, é 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: Clique para salvar e fechar a configuração de 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 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 de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas 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 origem para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou pode usar a conexão de Banco de Dados em um script.

Configurar atividades

Estes tipos de atividade estão disponíveis:

  • Consulta: Consulta dados de um endpoint de Banco de Dados e é destinada a ser usada como uma origem 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 um 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 um 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 um 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.)

Usar conexões de banco de dados em scripts

Pode-se referenciar conexões de banco de dados em um script usando funções de script que usam um databaseId como parâmetro:

Funções Jitterbit Script

Funções JavaScript Jitterbit

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