Conexão com banco de dados
Introdução
Uma conexão com 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 cloud Jitterbit ou instalado em agentes privados Jitterbit. Após configurar uma conexão, cria-se instâncias de atividades de banco de dados associadas àquela conexão para serem usadas como origem (para fornecer dados em uma operação) ou como destino (para consumir dados em uma operação).
Nota
Este conector suporta a política de organização Habilitar Reautenticação ao Alterar organização. Se habilitada, uma alteração em Nome do Servidor ou Login na conexão de um endpoint exigirá que os usuários reinsiram a Senha para a conexão.
Criar ou editar uma conexão com banco de dados
Cria-se uma nova conexão com banco de dados usando o conector de banco de dados a partir de um destes locais:
- A guia Project endpoints and connectors (Endpoints do projeto e conectores) da paleta de componentes de design (consulte Design component palette).
- A página Global Endpoints (Endpoints Globais) (consulte Criar um endpoint global em Global Endpoints).
Uma conexão com banco de dados existente pode ser editada a partir destes locais:
- A guia Project endpoints and connectors (Endpoints do projeto e conectores) da paleta de componentes de design (consulte Design component palette).
- A guia Components (Componentes) do painel de projeto (consulte Component actions menu em Project pane Components tab).
- A página Global Endpoints (Endpoints Globais) (consulte Editar um endpoint global em Global Endpoints).
Configurar uma conexão com banco de dados
Cada elemento da interface do usuário da tela de configuração da conexão com 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.
-
Connection name (Nome da conexão): insira um nome para identificar a conexão com banco de dados. O nome deve ser único para cada conexão com banco de dados e não pode 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. -
Driver type (Tipo de driver): para filtrar a lista de drivers, selecione o botão para o tipo de driver apropriado. Agentes cloud suportam um conjunto limitado de drivers JDBC apenas, 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 cloud 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 mostrados.
-
Server name (Nome do servidor): insira o nome, URL ou endereço IP do servidor de banco de dados.
Aviso
A versão do agente 12.10 e posteriores bloqueiam uma conexão de banco de dados para
localhostou127.0.0.1por 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, digite o nome do banco de dados. Este campo pode não estar presente para drivers de banco de dados em que não é aplicável, como Oracle.
-
Login e Senha: Se aplicável, digite um nome de usuário e 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 varia 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 digite a porta a ser usada no campo Porta abaixo.
-
Porta: (Este campo fica habilitado apenas se a caixa Usar Porta Padrão estiver desmarcada.) Digite uma porta personalizada apenas se o servidor do 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 uma delas habilita a mesma funcionalidade.
Importante
Para o driver JDBC do MySQL, adicione também
rewriteBatchedStatements=trueem Parâmetros de Cadeia de Conexão Adicionais 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 uma delas 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 compatíveis. A opção PADRÃO usa o nível de isolamento de transação padrão do driver ou servidor de banco de dados.
-
Tempo Limite (seg): Para definir um limite de quanto tempo aguardar uma conexão bem-sucedida com o banco de dados, digite um número de segundos aqui. O padrão é 300 segundos (5 minutos).
Dica
Este limite também se aplica quando a pooling de conexões da versão do agente 12.11 ou posterior cria uma nova conexão física; em um agente privado, consulte
[SourceTargetPooling]no arquivo de configuração do agente. A pooling adiciona uma configuração separada dejdbc.hikari.connectionTimeoutpara 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 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 de Cadeia de Conexão Adicionais: Digite aqui quaisquer parâmetros adicionais para a cadeia de conexão do banco de dados. Este campo fica desabilitado ao usar a opção de cadeia de conexão abaixo.
Dica
Ao usar o SQL Server MS JDBC (driver JDBC do Microsoft para SQL Server), digite
authentication=ActiveDirectoryPasswordneste 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 do servidor.Atenção
A versão do agente 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 agente privado, consulte
[JdbcSecurity]no arquivo de configuração do agente para ver 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, desabilita e sobrescreve os Parâmetros Adicionais de String de Conexão acima. Se selecionada e o campo String de Conexão ficar em branco, usa-se 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 habilitado.
!!! 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 claro durante a configuração, portanto, pode não ser desejável 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 acrescentados à 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 os parâmetros restritos e como permitir aquele que você precisa. -
Testar: Clique para verificar a conexão com o banco de dados. Ao testar uma conexão de banco de dados, identifica-se o caractere de aspas usado pelo banco de dados, aspas simples ou duplas. Se não testar a conexão neste momento, as informações de aspas de abertura e fechamento serão obtidas quando configurar uma atividade.
-
Salvar: 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 confirmação de que se 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 confirmação de que se deseja excluir a conexão.
Próximas etapas
As ações de menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para detalhes, consulte Menus de ações em Fundamentos do conector.
Após configurar uma conexão de banco de dados, é possível configurar uma ou mais atividades de banco de dados associadas a essa conexão para ser usada como origem para fornecer dados a uma operação ou como destino para consumir dados em uma operação, ou usar a conexão de banco de dados em um script.
Configurar atividades
Estes tipos de atividade estão disponíveis:
-
Query: Consulta dados de um endpoint de banco de dados e é destinada a ser usada como origem em uma operação ou chamada em um script.
-
Insert: Insere novos dados em um endpoint de banco de dados e é destinada a ser usada como destino em uma operação ou chamada em um script.
-
Update: Atualiza dados existentes em um endpoint de banco de dados e é destinada a ser usada como 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 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 Query, Insert e Update.)
Usar conexões de banco de dados em scripts
Você pode 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
CacheLookupCallStoredProcedureDBCloseConnectionDBExecuteDBLookupDBLookupAllDBRollbackTransactionDBWrite
Funções Jitterbit JavaScript
Para mais detalhes sobre como referenciar endpoints em scripts, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.