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 de operações, consulte 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 File > New > New Source; ou

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

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

No popup, selecione Database como o tipo:

Sua nova fonte aparece em sua própria aba New Source 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 por:

• Clicando duas vezes no ícone de fonte; no popup, selecione Create New Source; ou

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

Na tela de configuração que aparece, use o dropdown Type para selecionar Database, 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 defini-la por qualquer um dos seguintes métodos:

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

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

• Arrastando a fonte de banco de dados desejada da árvore à esquerda e soltando-a no ícone de 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 de fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração básica

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

• 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 Button de seleção (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.

    Cuidado

    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 para usar no campo Porta.
• Testar Conexão: Clicar no botão testará a fonte de dados do 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:

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

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:

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

• Tamanho de Busca: Se um driver JDBC for usado, um Tamanho de Busca pode ser especificado, dando ao driver uma dica sobre o número de linhas a buscar quando linhas adicionais forem necessárias. Esta configuração pode melhorar o processamento de grandes conjuntos de dados.

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

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