Criar uma fonte de banco de dados no Jitterbit Design Studio

Introdução

Uma fonte de banco de dados fornece acesso de leitura a bancos de dados usando drivers JDBC ou ODBC.

Criar uma fonte de banco de dados

Você pode optar por criar uma nova fonte de banco de dados por conta própria ou dentro de uma operação existente. Para mais informações sobre como as fontes funcionam dentro das operações, veja Criando uma operação.

Criar uma nova fonte de banco de dados como uma fonte independente

Dentro do seu projeto no Jitterbit Design Studio, você cria uma nova fonte de banco de dados por qualquer um dos seguintes métodos:

• Vá para Arquivo > Novo > Nova Fonte; ou

• No painel à esquerda, clique com o botão direito em Fontes e selecione Nova Fonte; ou

• Na barra de ferramentas superior, clique no ícone verde de fonte .

Na janela pop-up, selecione Banco de Dados como o tipo:

Sua nova fonte aparece em sua própria aba Nova Fonte no painel direito da janela.

Criar uma nova fonte de banco de dados em uma operação existente

Uma fonte é geralmente criada 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 sua fonte:

• Clicando duas vezes no ícone da fonte; na janela pop-up, selecione Criar Nova Fonte; ou

• Clique com o botão direito no ícone da fonte e selecione Criar Nova Fonte.

Na tela de configuração que aparece, use o dropdown Tipo para selecionar Banco de Dados, conforme mostrado acima.

Usar uma fonte de banco de dados existente em uma operação existente

Para usar uma fonte de Banco de Dados existente em uma operação existente com uma fonte, você pode configurá-la de qualquer uma das seguintes maneiras:

• Dentro da operação, clique duas vezes no ícone da fonte e, na janela pop-up resultante, selecione a fonte de Banco de Dados desejada na lista; ou

• Dentro da operação, clique com o botão direito no ícone da fonte, escolha Selecionar Fonte Existente e, na janela pop-up resultante, selecione a fonte de Banco de Dados desejada na lista; ou

• Arrastando a fonte de Banco de Dados desejada da árvore à esquerda e soltando-a no ícone da fonte existente da operação.

Configurar uma fonte de banco de dados

Depois de criar uma fonte 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 da fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração básica

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

• Nome: Insira um nome apropriado e único para a fonte.
• Tipo: Use o dropdown para selecionar Banco de Dados, se ainda não estiver especificado.
• Parâmetros de Conexão: Especifique os detalhes para sua conexão com o banco de dados:
  • Driver: Insira um nome de driver, manualmente ou clicando no botão Selecionar (preferido) ao lado do campo do driver. Dependendo do driver selecionado (veja Drivers de banco de dados abaixo), certos campos na configuração da fonte são habilitados ou desabilitados.
  • Nome do Servidor: Insira o nome do servidor ou o endereço IP do servidor a ser acessado.
  • Nome do Banco de Dados: Insira o nome do banco de dados a ser acessado.
  • Login: Se um login for necessário, insira um nome de usuário válido no campo Login.
  • Senha: Insira uma senha para usar com o Login para acessar o banco de dados.
  • Usar porta padrão: A porta padrão variará dependendo do driver de banco de dados selecionado. Para uma porta diferente, desmarque a caixa de seleção Usar porta padrão e insira uma porta a ser usada no campo Porta.
• Testar Conexão: Clicar no botão testará a fonte de Banco de Dados; a conexão falhará se não for possível estabelecer 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 dos drivers de banco de dados aparecerá semelhante a este exemplo:

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 de origem são habilitados ou desabilitados. 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 (JDBC 19.7)
• 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 de Windows e Linux de 64 bits:

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

Estes drivers ODBC estão incluídos na instalação do agente privado de Windows de 64 bits:

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

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

• PostgreSQL-jitterbit

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

Options

Parâmetros de conexão adicionais podem ser especificados clicando em Options na parte inferior da seção Connection Parameters:

• Transaction Isolation Level: 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 (sec): Especifica o limite de espera para uma conexão bem-sucedida com o banco de dados em segundos. O padrão é 300 segundos (5 minutos).

• Fetch Size: Se um driver JDBC for utilizado, um Fetch Size pode ser especificado, dando ao driver uma dica sobre o número de linhas a serem buscadas quando linhas adicionais forem necessárias. Essa configuração pode melhorar o processamento de grandes conjuntos de dados.

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

• Construct connection string manually: Marcar esta opção permite a entrada da string de conexão manualmente no campo abaixo da caixa de seleção. Isso desativará os Additional Connection String Parameters. Veja Manual connection string para mais detalhes.