Ir para o conteúdo

Criar um alvo de banco de dados no Jitterbit Design Studio

Introdução

Um alvo de banco de dados fornece acesso de escrita a bancos de dados usando drivers JDBC ou ODBC.

Nota

Os endpoints criados com uma fonte/alvo de banco de dados estão incluídos no relatório de uso de endpoints e contam para sua licença.

Criar um alvo de banco de dados

Você pode optar por criar um novo alvo de banco de dados independentemente ou dentro de uma operação existente. Para mais informações sobre como os alvos funcionam dentro de operações, consulte Criando uma operação.

Criar um novo alvo de banco de dados como alvo independente

Dentro do seu projeto no Jitterbit Design Studio, crie um novo alvo de banco de dados por qualquer um dos seguintes métodos:

  • Acesse File > New > New Target; ou

  • Na árvore à esquerda, clique com o botão direito em Targets e selecione New Target; ou

  • Na barra de ferramentas superior, clique no ícone de alvo azul attachment.

No popup, selecione Database como o tipo:

attachment

Seu novo alvo aparece em sua própria aba New Target no painel direito da janela.

Nota

Se você criar um alvo independente usando qualquer um desses métodos, observe que ele não está conectado a uma operação. Consulte Usar um alvo de banco de dados existente em uma operação existente abaixo para usar o novo alvo.

Criar um novo alvo de banco de dados em uma operação existente

Um alvo geralmente é criado por padrão quando você cria uma nova operação. (A exceção é uma operação que consiste apenas em um script.) Com uma operação existente, você pode especificar o tipo de seu alvo por:

  • Clicando duas vezes no ícone de alvo; no popup, selecione Create New Target; ou

  • Clicando com o botão direito no ícone de alvo e selecionando Create New Target.

Na tela de configuração que aparece, use o dropdown Type para selecionar Database, conforme mostrado acima.

Usar um alvo de banco de dados existente em uma operação existente

Para usar um alvo de banco de dados existente em uma operação existente com um alvo, você pode defini-lo por qualquer um dos seguintes métodos:

  • Dentro da operação, clicando duas vezes no ícone de alvo e, no popup resultante, selecionando o alvo de banco de dados desejado da lista; ou

  • Dentro da operação, clicando com o botão direito no ícone de alvo, escolhendo Select Existing Target e, no popup resultante, selecionando o alvo de banco de dados desejado da lista; ou

  • Arrastando o alvo de banco de dados desejado da árvore à esquerda e soltando-o no ícone de alvo existente da operação.

Configurar um alvo de banco de dados

Depois de criar um alvo de banco de dados, a tela de configuração será aberta na visualização principal do Design Studio. Você pode retornar à tela de configuração a qualquer momento clicando duas vezes no ícone de alvo na operação ou clicando duas vezes no alvo na árvore à esquerda.

Configuração básica

A tela de configuração aparecerá de forma semelhante a este exemplo:

attachment

  • Name: Digite um nome apropriado e único para a fonte.
  • Type: Use o dropdown para selecionar Database, se ainda não estiver especificado.
  • Connection Parameters: Especifique os detalhes da sua conexão de banco de dados:

    • Driver: Digite um nome de driver, manualmente ou clicando no botão Select (preferido) ao lado do campo de driver. Dependendo do driver selecionado (consulte Database drivers abaixo), certos campos na configuração da fonte são ativados ou desativados.
    • Server Name: Digite o nome do servidor ou endereço IP do servidor a ser acessado.

      Aviso

      O Agent versão 12.10 e posterior bloqueia uma conexão de banco de dados para localhost ou 127.0.0.1 por padrão, por segurança. Em um agent privado, consulte [JdbcSecurity] no arquivo de configuração do agent para permitir um banco de dados em execução no mesmo host que o agent.

  • Nome do Banco de Dados: Digite o nome do banco de dados a ser acessado.

  • Login: Se um login for necessário, digite um nome de usuário válido no campo Login.
  • Senha: Digite uma senha para usar com o Login para acessar o banco de dados.
  • Usar porta padrão: A porta padrão varia dependendo do driver de banco de dados selecionado. Para uma porta diferente, desmarque a caixa de seleção Usar porta padrão e digite uma porta a usar no campo Porta.
  • Testar Conexão: Clicar no botão attachment testará a fonte de Banco de Dados; falhará se não conseguir fazer uma conexão com o servidor de banco de dados com os parâmetros de conexão fornecidos.
  • Clique no botão Salvar na barra de ferramentas principal ou na barra de ferramentas do destino para salvar a configuração.

Drivers de banco de dados

A caixa de diálogo de drivers de banco de dados aparecerá de forma semelhante a este exemplo:

attachment

Clicar no botão Atualizar atualizará a lista exibida de drivers disponíveis no agente. A lista pode ser filtrada por tipo (JDBC ou ODBC) e nome. (Drivers ODBC são suportados apenas em agentes privados.) Dependendo do driver selecionado, certos campos na configuração da fonte são ativados ou desativados. Para adicionar drivers adicionais a um agente, consulte Instalar drivers ODBC ou JDBC adicionais.

Os drivers disponíveis dependem se você está usando agentes em nuvem ou agentes privados.

Agentes em nuvem

Grupos de agentes em nuvem suportam apenas drivers JDBC. Estes drivers JDBC são fornecidos:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server MS JDBC (Microsoft)
  • 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 suportam drivers ODBC de 32 bits e agentes de 64 bits suportam drivers ODBC de 64 bits.

Estes drivers JDBC são fornecidos por agentes privados Windows e Linux de 64 bits:

  • Amazon Redshift
  • IBM DB2 (AS400)
  • IBM DB2 (JCC)
  • MySQL
  • Oracle
  • Oracle NetSuite
  • PostgreSQL
  • SQL Server jTDS
  • SQL Server MS JDBC (Microsoft)
  • SQLite
  • Sybase jTDS

Estes drivers ODBC são inclusos na instalação do agente privado Windows de 64 bits:

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

Este driver ODBC é incluído na instalação do agente privado Linux de 64 bits:

  • PostgreSQL-jitterbit

Nota

Apenas drivers para agentes privados de 64 bits são listados acima, pois agentes privados de 32 bits estão fora de suporte.

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

Opções

Parâmetros de conexão adicionais podem ser especificados clicando em Opções na parte inferior da seção Parâmetros de Conexão:

attachment

  • Otimizar para Dados em Massa: Melhora o desempenho ao fazer upsert de grandes quantidades de dados via JDBC para Microsoft SQL Server ou um banco de dados Oracle.

  • 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 servidor de banco de dados.

  • Tempo Limite (seg): Especifica o limite de tempo para aguardar uma conexão bem-sucedida com o banco de dados em segundos. O padrão é 300 segundos (5 minutos).

  • Parâmetros de Cadeia de Conexão Adicionais: Parâmetros adicionais que devem ser adicionados à cadeia de conexão do banco de dados podem ser inseridos neste campo. Os parâmetros da cadeia de conexão são específicos do driver de banco de dados que você usa (ou seja, Microsoft SQL, MySQL, PostgreSQL, Oracle, etc.). Consulte as especificações do driver para determinar os parâmetros necessários.

Cuidado

A versão 12.10 do Agent e posteriores bloqueiam ou restringem 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] no arquivo de configuração do agent para ver os parâmetros restritos e como permitir um que você precise.

  • Construir string de conexão manualmente: Marcar esta opção permite inserir a string de conexão manualmente no campo abaixo da caixa de seleção. Isso desabilitará os Parâmetros Adicionais da String de Conexão. Consulte String de conexão manual para obter detalhes.

Dica

Consulte Convertendo uma fonte ou destino de banco de dados para usar um driver JDBC para obter instruções sobre como converter de um driver ODBC para um driver JDBC.